Update readme.md, including a table of contents

Added a table of contents and som cross-referencing anchorlinks plus other minor changes/fixes.