package info files are not up-to-date

[orbeckst]

Expected behavior

The package files (README, INSTALL, etc) and SUMMARY.txt (which shows up at https://pypi.org/project/MDAnalysis/) are in sync with the top-level README.rst, website, and docs.

Actual behavior

• INSTALL and README differ slightly from https://userguide.mdanalysis.org/installation.html, https://www.mdanalysis.org/pages/installation_quick_start/, and https://github.com/MDAnalysis/mdanalysis/blob/develop/README.rst
• SUMMARY.rst (https://pypi.org/project/MDAnalysis/) has wrong badge for Travis and outdated text (compared to https://github.com/MDAnalysis/mdanalysis/blob/develop/README.rst)

Proposed solution

Reduce the number of independent files that need to be kept updated. For instance, replace SUMMARY.txt with README.rst.

[orbeckst]

Nice-to-have for backport PR #2798

[orbeckst]

Note to self. Ways to check that PyPi will not choke on perfectly fine reST in README.rst/SUMMARY.txt

• python setup.py check --restructuredtext --strict
• twine check (which runs readme-renderer (which apparently is used to render the long_description))

[orbeckst]

Currently fails:

python setup.py sdist
twine check dist/MDAnalysis-2.0.0.dev0.tar.gz

with

Checking dist/MDAnalysis-2.0.0.dev0.tar.gz: FAILED
  `long_description` has syntax errors in markup and would not be rendered on PyPI.
    line 15: Warning: "raw" directive disabled.

Maybe we want to add a travis job that tests if a distribution could be successfully built and uploaded to pypi, i.e., the above two commands?

[orbeckst]

For the raw-html problem: use the 200x61px NF logo from MDAnalysis/MDAnalysis.github.io@ec4fe2c ...