Review of the current code

This is necessary to allow github comments on all the code. Don't
actually merge this!
If you're used to it then that's fair enough. I know a number of high-rated Topcoders do a similar thing.