Updates formatting on doc recently moved from wiki

This PR closes issue #1283.

Changes to Restructured text to clean up file.
Has there been an issue filed for this? I should look for it, and file it if not.