revise comments to match current state of project.