Apr 30 2010
Every Talk With a Consulting Company Ever, Re: Commenting*
You: Our current code is completely uncommented. Do you comment your code?
Them: Yes, we comment.
You: Excellent, commented code is very important to us.
Later…
You: This code has no comments.
Them: We will comment after things are done.
You: …really?
Finally…
You: Wait, we’re all finished, where are the comments?
Them: Allow us to explain our methodology of why code comments are actually unneeded and cumbersome.
You: …
* Regardless of the relative merits of comments vs. clean code that describes itself, it’s hilarious that anyone takes this particular kabuki dance seriously.**
** I could have probably titled this “Every talk with a programmer ever, Re: Commenting.” Ah well.
