Updates formatting on doc recently moved from wiki

This PR closes issue #1283.

Changes to Restructured text to clean up file.
Should this have similar formatting to the new note added about twill?