Fix: documentation refs, headers, indentation
Merge pull request #1141 from s3v/doc-fixes

Fix: documentation refs, headers, indentation and code blocks