Issue #2358369 by balagan, Katiemouse: getParameters() vs. getRawParameters()...

Issue #2358369 by balagan, Katiemouse: getParameters() vs. getRawParameters() on RouteMatch should not be documented the same

core/lib/Drupal/Core/Routing/RouteMatchInterface.php

@@ -39,7 +39,13 @@ public function getRouteName();
   public function getRouteObject();
 
   /**
-   * Returns the value of a named route parameter.
+   * Returns the processed value of a named route parameter.
+   *
+   * Raw URL parameters are processed by the parameter conversion system, which
+   * does operations such as converting entity ID parameters to fully-loaded
+   * entities. For example, the path node/12345 would have a raw node ID
+   * parameter value of 12345, while the processed parameter value would be the
+   * corresponding loaded node object.
    *
    * @param string $parameter_name
    *   The parameter name.
@@ -47,14 +53,24 @@ public function getRouteObject();
    * @return mixed|null
    *   The parameter value. NULL if the route doesn't define the parameter or
    *   if the parameter value can't be determined from the request.
+   *
+   * @see \Drupal\Core\Routing\RouteMatchInterface::getRawParameter()
    */
   public function getParameter($parameter_name);
 
   /**
-   * Returns the bag of all route parameters.
+   * Returns the bag of all processed route parameters.
+   *
+   * Raw URL parameters are processed by the parameter conversion system, which
+   * does operations such as converting entity ID parameters to fully-loaded
+   * entities. For example, the path node/12345 would have a raw node ID
+   * parameter value of 12345, while the processed parameter value would be the
+   * corresponding loaded node object.
    *
    * @return \Symfony\Component\HttpFoundation\ParameterBag
    *   The parameter bag.
+   *
+   * @see \Drupal\Core\Routing\RouteMatchInterface::getRawParameters()
    */
   public function getParameters();
 
@@ -68,6 +84,8 @@ public function getParameters();
    *   The raw (non-upcast) parameter value. NULL if the route doesn't define
    *   the parameter or if the raw parameter value can't be determined from the
    *   request.
+   *
+   * @see \Drupal\Core\Routing\RouteMatchInterface::getParameter()
    */
   public function getRawParameter($parameter_name);
 
@@ -76,6 +94,8 @@ public function getRawParameter($parameter_name);
    *
    * @return \Symfony\Component\HttpFoundation\ParameterBag
    *   The parameter bag.
+   *
+   * @see \Drupal\Core\Routing\RouteMatchInterface::getParameters()
    */
   public function getRawParameters();