I can agree with the seeming intention of the OP, but the analogy of adding labels to wires in an electrical box is problematic. How does having blank labels on wires equate to poor commenting?
Good or bad, a comment says something about the code it's commenting (even if the code is self explanatory). A blank label says nothing about the wire.
The better analogy might be having labels on wires that state the color of the wires -- red, blue, green, etc.
Good or bad, a comment says something about the code it's commenting (even if the code is self explanatory). A blank label says nothing about the wire.
The better analogy might be having labels on wires that state the color of the wires -- red, blue, green, etc.