diff --git a/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameter.rst b/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameter.rst
index 213dcfd6e4..68a10e824b 100644
--- a/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameter.rst
+++ b/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameter.rst
@@ -3,6 +3,8 @@
 parameter
 =========
 
+Extracts a *query* parameter value from the request.
+
 An alias for :ref:`-parameters-`.
 
 Signature
@@ -14,7 +16,9 @@ Signature
 Description
 -----------
 
-See :ref:`-parameters-`
+See :ref:`-parameters-` for a detailed description of this directive.
+
+See :ref:`which-parameter-directive` to understand when to use which directive.
 
 Example
 -------
diff --git a/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameterMap.rst b/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameterMap.rst
index 17f934980d..fe842aabcc 100644
--- a/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameterMap.rst
+++ b/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameterMap.rst
@@ -17,9 +17,7 @@ Description
 
 If a query contains a parameter value several times, the map will contain the last one.
 
-See :ref:`which-parameter-directive` for other
-choices.
-
+See :ref:`which-parameter-directive` to understand when to use which directive.
 
 Example
 -------
diff --git a/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameterMultiMap.rst b/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameterMultiMap.rst
index 70d5710dd2..b92299d9fe 100644
--- a/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameterMultiMap.rst
+++ b/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameterMultiMap.rst
@@ -18,7 +18,7 @@ Description
 This directive can be used if parameters can occur several times. The order of values is
 not specified.
 
-See :ref:`which-parameter-directive` for other choices.
+See :ref:`which-parameter-directive` to understand when to use which directive.
 
 Example
 -------
diff --git a/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameters.rst b/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameters.rst
index e5ca2e6458..2a271693c6 100644
--- a/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameters.rst
+++ b/akka-docs-dev/rst/scala/http/routing-dsl/directives/parameter-directives/parameters.rst
@@ -59,49 +59,49 @@ Examples
 --------
 
 Required parameter
-++++++++++++++++++
+^^^^^^^^^^^^^^^^^^
 
 .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala
    :snippet: required-1
 
 Optional parameter
-++++++++++++++++++
+^^^^^^^^^^^^^^^^^^
 
 .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala
    :snippet: optional
 
 Optional parameter with default value
-+++++++++++++++++++++++++++++++++++++
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala
    :snippet: optional-with-default
 
 Parameter with required value
-+++++++++++++++++++++++++++++
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala
    :snippet: required-value
 
 Deserialized parameter
-++++++++++++++++++++++
+^^^^^^^^^^^^^^^^^^^^^^
 
 .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala
    :snippet: mapped-value
 
 Repeated parameter
-++++++++++++++++++
+^^^^^^^^^^^^^^^^^^
 
 .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala
    :snippet: repeated
 
 Csv valued parameter
-++++++++++++++++++++
+^^^^^^^^^^^^^^^^^^^^
 
 .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala
    :snippet: csv
 
 Repeated, deserialized parameter
-++++++++++++++++++++++++++++++++
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/ParameterDirectivesExamplesSpec.scala
    :snippet: mapped-repeated