coding with passion and ignorance

Over-commenting is a delicate art

Here's a story about a coder who commented on every single line of code, turning what was supposed to be a simple web page into a behemoth of verbosity.

The coder was a prophet, a seer, a visionary who saw the code as a canvas waiting to be filled with their divine insight.

But the other coders in the team thought they were being right, each one adding their own two cents, turning the code into a never-ending stream of comments and sub-comments and meta-comments.

And so the code grew, a behemoth of confusion, a labyrinth of comments that no one could ever hope to navigate.

Comments

  1. Commenter 1: "I think we should use a different color for the background"
  2. Commenter 2: "But what about the header? Should we use Comic Sans too?"
  3. Commenter 3: "I don't know about the header, but I think we should use more comments."