add comments, prepare pull request notes