Improve README.

• Format in Markdown.
• Improve body text.
• Add maintainer details.
Make docstrings, comments and help text clearer.