Further doc fixes

This PR adds some further fixes to the updated documentation: 

1. Fixed source code links to Github

2. Special handling of block quotes at the top of documentation and immediately following h1s (quote-style), vs. inline block quotes

3. Minor css + rST fixes to command line options in