Merge branch '5.1' into 5.x

* 5.1:
  Add priority order explanation for tagged services
  Update routing.rst

Author: javiereguiluz

routing.rst

@@ -1562,7 +1562,7 @@ when importing the routes.
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
-            // use the optional fifth argument of import() to exclude some files
+            // use the optional fourth argument of import() to exclude some files
             // or subdirectories when loading annotations
             $routes->import('../../src/Controller/', 'annotation')
                 // this is added to the beginning of all imported route URLs

service_container/tags.rst

@@ -594,8 +594,9 @@ application handlers::
 Tagged Services with Priority
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The tagged services can be prioritized using the ``priority`` attribute,
-thus providing a way to inject a sorted collection of services:
+The tagged services can be prioritized using the ``priority`` attribute.
+The priority is a positive or negative integer. The higher the number,
+the earlier the tagged service will be located in the collection:
 
 .. configuration-block::
 
@@ -653,7 +654,7 @@ service itself::
         }
     }
 
-If you want to have another method defining the priority 
+If you want to have another method defining the priority
 (e.g. ``getPriority()`` rather than ``getDefaultPriority()``),
 you can define it in the configuration of the collecting service: