readme notes
added documentation and some pep8 fixes