A few months ago, I published The Power of a Conversational Code Review Culture. I talked about the importance of being generous with your code examples. Using GitHub’s built-in suggestions or posting diffs with the changes you have in mind go a long way towards helping the Pull Request’s author. It makes it easier for them to understand your suggestion, and include it in their code.


If you’re the reviewer and you already do this, kudos to you! Today I’d like to focus on the point of view of the Pull Request author.