final push with comments to methods, now in a class near you