Started improving the comments
More code comment fixes. Changes to README.md.