Humbly suggesting improvements to workflow document

This is not really a patch, but more of a "code review" in the form of additional in-line comments
to the documentation.