Merge branch '4.3' into 4.4

* 4.3:
  Fixed RST issues
  [Workflow] Fixes the examples related to metadata

Author: javiereguiluz

service_container/service_subscribers_locators.rst

@@ -427,29 +427,29 @@ of the ``key`` tag attribute (as defined in the ``index_by`` locator option):
         <container xmlns="http://symfony.com/schema/dic/services"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/services
-                http://symfony.com/schema/dic/services/services-1.0.xsd">
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
                 <service id="App\Handler\One">
-                    <tag name="app.handler" key="handler_one" />
+                    <tag name="app.handler" key="handler_one"/>
                 </service>
 
                 <service id="App\Handler\Two">
-                    <tag name="app.handler" key="handler_two" />
+                    <tag name="app.handler" key="handler_two"/>
                 </service>
 
                 <service id="App\HandlerCollection">
                     <!-- inject all services tagged with app.handler as first argument -->
-                    <argument type="tagged_locator" tag="app.handler" index-by="key" />
+                    <argument type="tagged_locator" tag="app.handler" index-by="key"/>
                 </service>
             </services>
         </container>
 
     .. code-block:: php
 
         // config/services.php
-        use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
         use Symfony\Component\DependencyInjection\Argument\ServiceLocatorArgument;
+        use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
 
         $container->register(App\Handler\One::class)
             ->addTag('app.handler', ['key' => 'handler_one']);
@@ -517,14 +517,14 @@ attribute to the locator service defining the name of this custom method:
         <container xmlns="http://symfony.com/schema/dic/services"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/services
-                http://symfony.com/schema/dic/services/services-1.0.xsd">
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
 
                 <!-- ... -->
 
                 <service id="App\HandlerCollection">
-                    <argument type="tagged_locator" tag="app.handler" default-index-method="myOwnMethodName" />
+                    <argument type="tagged_locator" tag="app.handler" default-index-method="myOwnMethodName"/>
                 </service>
             </services>
         </container>

workflow.rst

@@ -673,18 +673,28 @@ Then you can access this metadata in your controller as follows::
             ->getWorkflowMetadata()['title'] ?? 'Default title'
         ;
 
-        // or
+        $maxNumOfWords = $workflow
+            ->getMetadataStore()
+            ->getPlaceMetadata('draft')['max_num_of_words'] ?? 500
+        ;
+
         $aTransition = $workflow->getDefinition()->getTransitions()[0];
-        $transitionTitle = $workflow
+        $priority = $workflow
             ->getMetadataStore()
             ->getTransitionMetadata($aTransition)['priority'] ?? 0
         ;
     }
 
-There is a shortcut that works with every metadata level::
+There is a ``getMetadata()`` method that works with all kinds of metadata::
+
+    // pass no arguments to getMetadata() to get "workflow metadata"
+    $title = $workflow->getMetadataStore()->getMetadata()['title'];
+
+    // pass a string (the place name) to getMetadata() to get "place metadata"
+    $maxNumOfWords = $workflow->getMetadataStore()->getMetadata('draft')['max_num_of_words'];
 
-    $title = $workflow->getMetadataStore()->getMetadata('title');
-    $priority = $workflow->getMetadataStore()->getMetadata('priority');
+    // pass a Transition object to getMetadata() to get "transition metadata"
+    $priority = $workflow->getMetadataStore()->getMetadata($aTransition)['priority'];
 
 In a :ref:`flash message <flash-messages>` in your controller::