Small fixes to make Github README page look better.

I'm using RST chapters and section to add some style to the project
front page on Github.