BPMN Editor – Document a Workflow
What You Will Learn
After finishing this tutorial, you will be able to provide documentation for your workflows.
To complete this guide you need:
Roughly 10 minutes
The PAK Bpmn Editor ( Download )
A user might not know what a workflow does. Give them a small explanation of what they can expect to happen when they run the workflow or explain its use case.
To add documentation simply click on the documentation tab in the tab view where you can also find the dataflow analysis, datastore and key consumption.
|Select this tab to open a text area containing the documentation of the workflow. Any already existing documentation should be shown in this tab.
|Click into the text area to edit the documentation.
To write a good documentation you need to understand what questions the user asks about the workflow.
Some of them might be:
What does the workflow do?
What can I do with this workflow?
What are the use cases of this workflow?
|Generally it is a good practice to think about what the user wants to know.
|Try to keep the documentation short and simple!
A short summary of the workflow provides the user with a short and quick overview of what this workflow does.
Most of the time the use case or application is also represented by the name of the workflow. However, a complex task might be to long to put into a name. You can elaborate the workflows task in the documentation.
Some workflows require the user to perform manual tasks or inputs. Give some instruction about the user task or give some information what the input is used for.
|The user might need some additional instructions about more complex tasks or wants to know what he needs to enter as input.
The workflow executor also provides some HTML support for the documentation. The guide about command documentation contains all relevant information about how you can use HTML tags in your documentation for workflows.