Formatting improvements

Various changes to the documentation that mostly fix broken formatting. A few petty changes were snuck in as well to make (what I feel is) a clearer presentation.

Of note is the inclusion of another extension. admonition was added to give us the ability to have banners to convey important messages that should not be overlooked.

This also fixes #1 (closed)