symfony
diff --git a/‎components/workflow.rst
Copy file name to clipboardExpand all lines: components/workflow.rst
+10Lines changed: 10 additions & 0 deletions b/‎components/workflow.rst
Copy file name to clipboardExpand all lines: components/workflow.rst
+10Lines changed: 10 additions & 0 deletions
diff --git a/‎workflow.rst
Copy file name to clipboardExpand all lines: workflow.rst
+15Lines changed: 15 additions & 0 deletions b/‎workflow.rst
Copy file name to clipboardExpand all lines: workflow.rst
+15Lines changed: 15 additions & 0 deletions
@@ -94,6 +94,16 @@ you can retrieve a workflow from it and use it as follows::
     $workflow->can($blogPost, 'publish'); // True
     $workflow->getEnabledTransitions($blogPost); // $blogPost can perform transition "publish" or "reject"
 
+If you want to initiate your worflow, you can simply call ``getMarking``::
+
+    // ...
+    $blogPost = new BlogPost();
+    $workflow = $registry->get($blogPost);
+
+    // initiate workflow
+    $workflow->getMarking($blogPost);
+
+
 Learn more
 ----------
 
 
@@ -356,11 +356,26 @@ order:
 
         The ``Workflow::DISABLE_ANNOUNCE_EVENT`` constant was introduced in Symfony 5.1.
 
+    .. versionadded:: 5.2
+
+        The context will be accessible in all the events::
+
+            // $context must be an array
+            $context = ['context'];
+            $workflow->apply($subject, $transitionName, $context);
+
+            // in an event listener
+            $context = $event->getContext(); // returns ['context']
+
 .. note::
 
     The leaving and entering events are triggered even for transitions that stay
     in same place.
 
+.. note::
+
+    If you initialize the marking by calling ``$workflow->getMarking($object);``, then the ``workflow.[workflow name].entered.[initial place name]`` will be called with a default context ``Workflow::DEFAULT_INITIAL_CONTEXT``
+
 Here is an example of how to enable logging for every time a "blog_publishing"
 workflow leaves a place::