Update documentation formatting

Updated documentation to include `autodoxygenindex`
With this in place,  the entire file as opposed
to just the class are documented.
Further onwards a small script to add `.rst` corresponding
to `.h` files should suffice in generating documentation.

- [x] Add `.rst` for all `.h` files (a script perhaps)
- [x] Use markdown to improve formatting.