Comments, some renames, other minor changes.

Updated README file, added comments in the code to help when
implementing, rename of methods in the code.