Update README to use reStructureText.
Fix broken hyperlinks in README.
Fix a code example formatting error in README.
Fix formatting problem in README.
Add missing full stop in README.