Some minor test errors, enhanced README.md 

Most of README.md is complete.
Might be better to improve some of the methods return descriptions.. although it could get too exhaustive!