From f03df932f81a985fe0b675319dbc79bafbe96591 Mon Sep 17 00:00:00 2001
From: Florent Destremau <florent.destremau@gmail.com>
Date: Sat, 30 Nov 2019 16:54:29 +0100
Subject: [PATCH] Added note regarding workflow "entered" event being
 dispatched on creation

---
 workflow.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index fd55f189609..f3b960ba6c5 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -215,7 +215,7 @@ 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
 ---------------------------------
 
@@ -223,21 +223,21 @@ To access workflow inside a class, use dependency injection and inject the
 registry in the constructor::
 
     use Symfony\Component\Workflow\Registry;
-    
+
     class MyClass
     {
-    
+
         private $workflowRegistry;
-    
+
         public function __construct(Registry $workflowRegistry)
         {
             $this->workflowRegistry = $workflowRegistry;
         }
-    
+
         public function toReview(BlogPost $blogPost)
         {
             $workflow = $this->workflowRegistry->get($blogPost);
-        
+
             // Update the currentState on the post
             try {
                 $workflow->apply($post, 'to_review');
@@ -339,6 +339,11 @@ order:
     The leaving and entering events are triggered even for transitions that stay
     in same place.
 
+.. versionadded:: 4.3
+
+    Following events are also dispatched when the subject enters the workflow
+    for the first time: ``workflow.entered`` and ``workflow.[worflow name].entered``.
+
 Here is an example of how to enable logging for every time a "blog_publishing"
 workflow leaves a place::