Rewrite the README to provide more useful info and include it in the package.
Review Request #10005 — Created June 6, 2018 and submitted
The new README is based on ReST, allowing us to provide a formatted
version compatible with GitHub and PyPI. The new version provides a
summary of every package, including links to the appropriate code
reference docs, and has sections on version compatibility, installing,
contributing patches, and filing bugs.
This new README is included in all package builds, allowing viewers on
PyPI to see it without navigating to the source.
Compiled the README to HTML and viewed the output, checking for broken
links or other noticeable errors.
Built a package and inspected the metadata, ensuring the new description