The Three Types Of Code Documentation

Left side: "My code is self-documenting!!" with a sketch of someone looking distressed at the lowest end of the IQ bell curve.

Middle: Actual documentation with detailed comments about monster attack algorithms in a game.

Right side: Someone who just writes "// this is bridge" next to a drawing of a bridge, sitting at the other low end of the IQ curve.

The perfect balance? The 130+ IQ person with comprehensive, helpful comments that actually explain the why behind complex game logic.

The eternal developer struggle: write no comments and claim "self-documenting code," write useless comments stating the obvious, or be the rare specimen who documents the intent and reasoning. Most of us oscillate between all three depending on how much coffee we've had.