update setup.py __doc__ with links; add example to main README.md