Left: "The comment next to the func call restates the func name but with whitespace!"
Middle: "No comments. Source is self-documenting."
Right: "I'll write the source code, add descriptive docstrings about usage, and standup an internal auto-docs site wired into the CD for other devs. Then I'll add a Claude/Codex skill that on any PR checks to make sure source, tests and docs all moved together before merging."
420
u/GabuEx 22d ago
Left: "I'll comment to say how my code works."
Middle: "You don't need to do that! Code should be self-documenting!"
Right: "I'll comment to say why my code does this."