add 'install from pypi' instructions
docs publishable on readhedocs.org
add general project info and links
Merge pull request #21 from magopian/docs-improvement

Small docs improvements.