Improving the documentation further
Improved documentation by

- removing tables in comments documentation
- rendering the html version of the documentation with proper hyperlinks