BK-1323 Reformat README and setup file

`setup.py` is now fully `pep8` compliant

As part of http://24pullrequests.com/
BK-1323 Reformat README and setup file

Updated README

The README.txt was renamed to README.md to present it nicely on Github.
Also updated the README itself and included some links and stuff.

As part of http://24pullrequests.com/