Thanks for sharing your idea. Using BPMN to document the behavior of state machines is certainly possible. I’m not sure if it is a good a idea to do so in the Zeebe docs, though, for these reasons:
- Zeebe is also targeted at people who are new to BPMN. We would like them to learn BPMN along as they learn Zeebe. They may not yet understand BPMN when they read about the basics of the system or could confuse those BPMN models with those that Zeebe executes.
- While BPMN can be used to document state machines, it is not a formal language to do so (e.g. a sequence flow label is not formally a transition condition). It may therefore be better to use a notation that is entirely informal and that users can clearly identify as informal.
I hope you enjoy reading the docs nevertheless. Please provide us with any more feedback that you may have. There is still a lot of room for improvement