DOC: Documentation fixes

Clean up documentation. Fix many problems that have crept in in new code. Closes all outstanding documentation issues for 0.6.
The `::` signals a literal block that needs indentation.