Add long_description to setup
Add note about a numpy installation bug.
Minor markup edits.
Update version to 3.1.0
Add notes about things to do when tagging new version