[IMP] doc: add some diagrams to workflow doc

Also move transitions to the bottom of the document, and try to clarify the
documentation for split, join and activity kinds.