added a few more pseudo code comments to methods