Google’s Engineering Practices – How to Navigate a Code Review

As we learn from Google about how to navigate a code review, Michael learns to not give out compliments, Joe promises to sing if we get enough new reviews, and Allen introduces a new section to the show.

For those reading this via their podcast player, this episode’s full show notes can be found at https://www.codingblocks.net/episode134.

Sponsors

• University of California, Irvine Division of Continuing Education – One of the top 50 nationally ranked universities, UCI offers over 80 certificates and specialized programs designed for working professionals. Registration is NOW OPEN! Sign up and reserve your seat today!
• Datadog.com/codingblocks – Sign up today for a free 14 day trial and get a free Datadog t-shirt after your first dashboard.

Survey Says

How many hours per week do you work on average?

Take the survey at: https://www.codingblocks.net/episode134.

News

• Thank you, we appreciate the latest reviews:
  • Stitcher: Jean Guillaume Misteli, gitterskow

LGTM

Navigating a CL in Review

A couple starting questions when reviewing a CL (changelist):

• Does the change make sense?
• Does the CL have a good description?

Take a broad view of the CL

• If the change doesn’t make sense, you need to immediately respond with WHY it shouldn’t be there.
  • Typically if you do this, you should probably also respond with what they should have done.
  • Be courteous.
  • Give a good reason why.
• If you notice that you’re getting more than a single CL or two that doesn’t belong, you should consider putting together a quick guide to let people know what should be a part of CL’s in a particular area of code
  • This will save a lot of work and frustration.

Examine the main parts of the CL

• Look at the file with the most changes first as that will typically aid in figuring out the rest of the CL quicker.
  • The smaller changes are usually part of that bigger change.
• Ask the developer to point you in the right direction.
• Ask to have the CL split into multiple smaller CL’s
• If you see a major problem with the CL, you need to send that feed