DEV Community

Discussion on: "Do not comment on your code, it should be self-documented". Well... I don't agree.

Collapse
 
norton120 profile image
Ethan Knox

A piece of the perpetual "self documenting vs commenting" argument that I don't see surfaced often is when you mix logging into the equation. Especially if you have a mature logging strategy with comprehensive debug log events, the same code that serves to improve observability also acts as a form of human-readable documentation