docs: continued updates to docs content

This commit mainly contains updates to the "rst-for-markdown-expats"
guide (i.e., for OMPI developers who are familiar with Markdown).

Signed-off-by: Jeff Squyres <jsquyres@cisco.com>

Author: jsquyres