Reordered and commented methods, cleaned up readme.

Some other small tweaks to enhance readability here and there.