Issue #2508037 by hussainweb, catch, Crell: Clarify PathProcessor path format

core/lib/Drupal/Core/PathProcessor/InboundPathProcessorInterface.php

@@ -18,8 +18,7 @@ interface InboundPathProcessorInterface {
    * Processes the inbound path.
    *
    * @param string $path
-   *   The path to process, with a starting slash.
-   *
+   *   The path to process, with a leading slash.
    * @param \Symfony\Component\HttpFoundation\Request $request
    *   The HttpRequest object representing the current request.
    *

core/lib/Drupal/Core/PathProcessor/OutboundPathProcessorInterface.php

@@ -19,7 +19,7 @@ interface OutboundPathProcessorInterface {
    * Processes the outbound path.
    *
    * @param string $path
-   *   The path to process.
+   *   The path to process, with a leading slash.
    * @param array $options
    *   An array of options such as would be passed to the generator's
    *   generateFromPath() method.
@@ -28,7 +28,7 @@ interface OutboundPathProcessorInterface {
    * @param \Drupal\Core\Render\BubbleableMetadata $bubbleable_metadata
    *   (optional) Object to collect path processors' bubbleable metadata.
    *
-   * @return
+   * @return string
    *   The processed path.
    */
   public function processOutbound($path, &$options = array(), Request $request = NULL, BubbleableMetadata $bubbleable_metadata = NULL);