[rschoultz]

This will be incredibly useful, thanks for posting. Now I need to learn what the GNU Free Documentation License allows, how/if it can be reused or derived.

Certainly, in my experience and where I currently am, most of the texts that are published externally receives good editing, but many communications and documents are not, and 90% of the documentation is for internal purposes. This guide might just make the documentation a bit improved and more fun.

Also I appreciate the details about appropriate use of "$" or "#" for prompts, to name one. That is the way one would expect since at least the days with Bourne shell in the 80s, but I have not seen it spelled out.