Fixing broken links and refactoring  for proper doc generation

- Changed heading from `h1` to `h2`, `h2` to `h3` and `h3` to `h4`
- Fixed all broken links