clean up comments for pull request and to be a little more descriptive