The Why’s of Tech Writing
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 …