DOC: Fix section header.
DOC: Remove unknown section title.
DOC: Cannot have arbitrary indents.
DOC: Parameter is NOT a section title.
DOC: Fix bullet lists.
DOC: Fix literal block.
DOC: Don't use substitution notation for abs.
DOC: Fix literal block issue.
DOC: Add note about docs to release process.
Merge pull request #1007 from jseabold/doc-cleanup

Cleanup docs for release