Skip to content

Commit 3934335

Browse files
committed
[#8048] some minor tweaks
1 parent 89781de commit 3934335

File tree

1 file changed

+7
-5
lines changed

1 file changed

+7
-5
lines changed

workflow/usage.rst

+7-5
Original file line numberDiff line numberDiff line change
@@ -180,14 +180,14 @@ Using Events
180180
To make your workflows more flexible, you can construct the ``Workflow``
181181
object with an ``EventDispatcher``. You can now create event listeners to
182182
block 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
184184
announcements).
185185

186186
Each 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

192192
The following events are dispatched:
193193

@@ -213,7 +213,7 @@ The following events are dispatched:
213213

214214
When 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+
254256
Guard events
255257
~~~~~~~~~~~~
256258

0 commit comments

Comments
 (0)