adding a proper table of contents to the readme

Note that doctoc munges the readme slightly, see
https://github.com/thlorenz/doctoc/issues/18 and
https://github.com/thlorenz/doctoc/issues/19