Updated readme

* Include a ToC
* Rejig headers
* Fix existing header linkx (github)