Joel Spolsky wonders:
Why does every technical manual and book include a section at the beginning on “conventions used in this document,” full of ridiculous and useless tips like, “Tips are indicated by a lightbulb icon in the margin”? Is it because you’re paid by the word?
We aren’t (paid by the word) and we don’t (begin our docs that way). Go free software!