Merge branch '4.4' into 5.0

* 4.4:
  [#12545] Slightly improved the title
  Show how to retrieve workflow in a class

Author: wouterj

workflow.rst

@@ -215,6 +215,38 @@ what actions are allowed on a blog post::
 
     // See all the available transitions for the post in the current state
     $transitions = $workflow->getEnabledTransitions($post);
+    
+Accessing the Workflow in a Class
+---------------------------------
+
+To access workflow inside a class, use dependency injection and inject the
+registry in the constructor::
+
+    use Symfony\Component\Workflow\Registry;
+    
+    class MyClass
+    {
+    
+        private $worflowRegistry;
+    
+        public function __construct(Registry $workflowRegistry)
+        {
+            $this->worflowRegistry = $worflowRegistry;
+        }
+    
+        public function toReview(BlogPost $blogPost)
+        {
+            $workflow = $this->worflowRegistry->get($blogPost);
+        
+            // Update the currentState on the post
+            try {
+                $workflow->apply($post, 'to_review');
+            } catch (LogicException $exception) {
+                // ...
+            }
+            // ...
+        }
+    }
 
 Using Events
 ------------