BPMN groups and annotations
Groups and text annotations are purely visual. They can span pools, they change nothing about execution, and they are the right place for anything the notation cannot express.
Use them freely; they are the reason a strict notation stays readable.
#When it matters
Marking phases, or drawing attention to a region of the diagram.
Recording assumptions, SLAs and exceptions the notation cannot show.
#The symbols
Symbol | Means |
|---|---|
Group | Dashed rounded rectangle. Visual grouping only. |
Text annotation | Bracket with text. Attached with an association. |
Association | Dotted line linking an annotation to an element. |
#A few things that catch people out
Groups have no execution meaning at all, which is why they may cross pools.
Annotate the timeouts and the assumptions. Those are what readers actually query.
If you need many annotations to explain the flow, the flow probably needs redrawing.
#Related
Sequence flow stays inside the pool.
