add classifiers to setup.py
Update the documentation.

Mostly by removing out of date stuff, but replacing it with
links to examples.