Readme suggestions

Just some minor readme formatting changes, mostly marking code with github markdown syntax. I've also included the release notes, linked to the documentation and created a table of contents.