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