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.
Merge pull request #10 from ewels/patch-1

merging Readme suggestions from Phil Ewens.