@@ -180,14 +180,14 @@ Using Events
180180To make your workflows more flexible, you can construct the ``Workflow ``
181181object with an ``EventDispatcher ``. You can now create event listeners to
182182block transitions (i.e. depending on the data in the blog post) and do
183- additional actions when a workflow operation happened (i.e. sending
183+ additional actions when a workflow operation happened (e.g. sending
184184announcements).
185185
186186Each step has three events that are fired in order:
187187
188- - An event for every workflow;
189- - An event for the workflow concerned;
190- - An event for the workflow concerned with the specific transition or place name;
188+ * An event for every workflow;
189+ * An event for the workflow concerned;
190+ * An event for the workflow concerned with the specific transition or place name.
191191
192192The following events are dispatched:
193193
@@ -213,7 +213,7 @@ The following events are dispatched:
213213
214214When a state transition is initiated, the events are fired in the following order:
215215
216- - guard: Validate whether the transition is allowed at all (see below);
216+ - guard: Validate whether the transition is allowed at all (:ref: ` see below < workflow-usage-guard-events >` );
217217- leave: The object is about to leave a place;
218218- transition: The object is going through this transition;
219219- enter: The object entered a new place. This is the first event where the object' is marked as being in the new place;
@@ -251,6 +251,8 @@ Here is an example how to enable logging for every time a the "blog_publishing"
251251 }
252252 }
253253
254+ .. _workflow-usage-guard-events :
255+
254256Guard events
255257~~~~~~~~~~~~
256258
0 commit comments