Merge pull request #1141 from s3v/doc-fixes

Fix: documentation refs, headers, indentation and code blocks
Fix: extensive documentation overhaul
Fix: documentation tree structure and various small usability fixes