Fixes to the README and improved method documentation