fix capitalisation
change long description to include "framework"
convert master's README to README.rst

* fix formatting (one sentence per line)
* copy one bold statement from long_description from setup.py
* use README.rst as long_description
make sure README is read from the right directory
Merge pull request #1472 from sa2ajj/fix-description

Fix description