On: Why was Pinball removed from Windows Vista?

[miahi]

What's really annoying is that most of the time you see this kind of comment there is no explanation why 10 was chosen.

[dhimes → miahi]

And that's what comments really need to do: tell 'why.'

[Pyrodogg → dhimes]

http://xkcd.com/221/

[MetallicCloud → miahi]

That's why you should use constants. Still self documenting without the need for comments (usually).

[adamzegelin → MetallicCloud]

    const TEN = 12;

[tehwalrus → adamzegelin]

    #define true false

[fudged71 → miahi]

In our embedded systems class we were required to define all of our constants, just to add another level of description to operations. It definitely helped to navigate spaghetti code.