A staff engineer's PR implements a complex algorithm without comments. When asked, they say the code is self-documenting. You disagree. How do you push back?

Question

Answer

Stay specific. One example, told well, beats three told fast. Make your decisions visible — what you chose between. End on what changed, for whom.

A staff engineer's PR implements a complex algorithm without comments. When asked, they say the code is self-documenting. You disagree. How do you push back?

Practice more