Code Clarity and Documentation

STOP - The Obviousness Rule

If a code reviewer says your code is not obvious, it is not obvious -- regardless of how clear it seems to you.

For new code: Write comments BEFORE implementation. If the comment is hard to write, fix the design, not the comment.

Comments-First Workflow

For new classes/methods, write comments BEFORE implementation: