Prettify the README a bit

I re-ordered some of the headings and reformatted the code examples so the comments are consistent and the examples don't need side scrolling.
Merge pull request #34 from jteneycke/patch-1

Prettify the README a bit