Documentation updates

[xross]

Results of reviewing docs in release_prep branch

• removed reference to defines that we don't expect users to set.
• removed use of full width table unless really required.
• branding updates and updates to match rst style guide