Merge branch 'fix-formatting' into 'master'

README.rst: Fix formatting

Formatting appears to be broken at present as `===` is being treated as
literal.

Fix it and also change other places to follow reStructuredText
guidelines:

- The underline/overline must be at least as long as the title text
- Have a separate adornment style for page title

See merge request !36