Fixed the issues causing warnings while building docs

* There were some indentation issues.
* Blank lines were required above and below code blocks.
* Some headings had problems