An aspiring software craftsman journey
Chess masters do game analysis and review after every single game they play. They are eager to learn from every single mistake they make. This is what makes them masters! When two chess masters do a game review, you may hear them saying:
The point is that game review is strictly about the game, the position, the moves that were played, but never about the player himself.
In “Starting from this position, white has serious problems”, “white” could be the chess master himself! He didn’t say “… I have serious problems”. Likewise, in “Black in this position has a slight advantage”, “Black” may refer to the opponent, He didn’t say “… You have a slight advantage”.
This is exactly how code reviews should be conducted between developers. The review should be about the code, never about the coder. Unfortunately, some code review sessions turn into personal attacks and may create trouble in the team and sadly impact the whole project.
I have worked with nice people who know how to apply code review’s best practices to be constructive and helpful. But I have also heard:
That was not necessarily about my code, but it’s true! and happens quite often sadly.. even between top notch developers (here are some examples from Linus Torvalds doing a code review of a pull request to the linux kernel).
Anyway, like chess masters, we should hear two code masters saying:
What a wonderful discussion! What a pleasant code review! The reviewer and the reviewee are both speaking about the code, not persons.
To conclude, two points to note:
This is actually a very simple rule, and if we apply it, our code review sessions could be really better.
Let me leave you with some great references on code reviews, all referring the simple rule discussed in this post: