adding a bunch of comments
Merge pull request #3 from conorhastings/master

adding a bunch of comments, making some variable names more explicit