move a lot of documentation from README and __init__.py into the sphinx docs.