Ask HN:What is the best comment in source code you have ever encountered?

https://news.ycombinator.com/item?id=6232500

by geektips • 13 years ago

10 4 13 years ago

news.ycombinator.com

What is the best comment in source code you have ever encountered?

orenbarzilai• 13 years ago

//when I wrote it only GOD and I knew what it does. Now only GOD knows.

gjsriv• 13 years ago

Quora has the answer already? Even Stackoverflow-http://stackoverflow.com/questions/184618/what-is-the-best-c...

mb_72• 13 years ago

It was a self-commenting C++ friend function named "ifyouusethisfunctioniwillstrangleyoumyself", written by our extremely talented team leader. There were a couple of times it was necessary to call this function; the name was there merely to make people think about whether they REALLY needed to call it. Discovering the function itself meant people had already identified some need in their code for it. So - no actual comment, but a very wonderful piece of code that make people think, and prompted many discussions about the correctness of what they were attempting.

o0-0o• 13 years ago

Customer(The.Bastard)

Found in GoldMine code in 2000 beta testing. Changed shortly after.

EDIT: Not actually a comment, it was a variable named Customer with a property (The.Bastard).

Ask HN:What is the best comment in source code you have ever encountered?

Related Stories