Why code review?There are lots of good reasons.Programming is hard.We work with smart people.Discussing our work can be positive.Increases overall quality.Helps solve difficult problems.Spreads knowledge.Helps develop strong shared standards.
Who are reviews for?Developers.So that we can learn from one another.
10 Commandmentsof egoless programming.Understand and accept that you will make mistake.You are not your code.No matter how much “karate” you know, someone else will always know more.Don’t rewrite code without consultation.Treat people who know less than you with respect, deference and patienceThe only constant in the world is change.The only true authority stems from knowledge, not from position.Fight for what you believe, but gracefully accept defeat.Don’t be “the guy in the room.”Critique code instead of people. Be kind to the coder, not the code.
We all make mistakes.The important thing is to catch them as early aspossible.Luckily our mistakes aren’t life threatening. We can fix them, move onand laugh about it.
You are not your code.The point of reviews is to find problems early,educate and learn.Don’t take it personally.
Always room to learn.We are all smart capable developers.Let’s learn from one another.
Ask why.Don’t just assume that something is wrong.Ask questions. Inquire about why something was done in a particularway. It might be the way it is for a valid reason.
Respect your peers.Even those that have been “in the game” for ashorter time then you have.We all have different levels of experience. Patience and respect goes along way.
Change is constant.Standards are a living thing.We need to work as a team to develop a culture of quality.
Knowledge over position.Everybody has valuable insight.Let’s cultivate that and build a knowledge based developmentenvironment.
Don’t dig in too deep.Fight for what you believe.Be willing to accept ideas that are different then the ones you have now.
Don’t hide.Building a positive development environmenttakes participation.Share what you know. Ask questions. Participate.
Critique Code.Not people.Be kind to the coder, not the code.
What is a “good” review?Good reviews spread knowledge and provide alearning experience for everybody involved.
a conversation...Reviews should be a two way conversationbetween the author of the code and theparticipants of the review.Reviewers should ask questions of the author. The author should offerexplanations and frame the context of the code being reviewed.
includes a summary...When a review is over it should be summarized.This will let all the participants know what action is being taken as aresult of the review.
includes praise...If you see something you like, let the authorknow.It can be difficult to remember to do this, but it is important.
references standards...Have a solid set of standard practices toreference.Remember that standards are a living thing. They are still open fordiscussion.
focus on the code...Not the person that wrote it.Ego is something we all have, but should be kept out of reviews as muchas possible.
not always actionable...Comments in a code review don’t necessarilyrequire immediate action.Be clear about that. Is a comment a suggestion? A question?
is time-boxed...Code reviews work best on code that is fresh inthe author’s mind.Respond to review requests promptly. Participate as much as possibleand mark the review complete when you are done.
Being reviewed.It can be tough to be in the hot seat and haveyour code examined.
Add initial comments.As the author adding an initial pass ofcomments is extremely helpful to explain thecode under review.Scope and context can be defined this way.
Decouple yourself...Take a step back and release your attachmentsto the work being reviewed.This is challenging. The initial instinct is to “bunker in” and defend thework.
Understand the standards.Work as closely to the defined standards aspossible.When you need to deviate explain why in the initial comment pass.
Maintain the standards.Standards are living things.If you deviate and need to do something a different way open thediscussion for improving the standards.
When to start a review?During active development while the code isfresh in your head is the best time to start areview.Peer review is not a task to save as until the end of development. Startingthe conversation early helps ensure that it isn’t an afterthought. Problemsare caught before they spin out of control.
Who starts a review?Generally the author.But sometimes it might be started by somebody else if a problem isnoticed or if a commit isn’t under review and is on the large side.