The Community for Technology Leaders
Green Image
It's no secret that customers frequently complain about programming manuals. In annual meetings, around the office coffee machine, in comp centers neath the abend's red glare — one can hear the people who depend on software documentation raising agonized cries. The problems that can be found in manuals are many, and familiar: minor irritants like Ted Mack spelling, blunders like lost table headings or illegible printing, yellow-brown fogs of vagueness, absent examples, missing information, even the deadly sin of downright factual mistakes — all these flaws are not uncommon.

F. J. Bethke, "Technical writing: Weaving the Silk purse," in Computer, vol. 7, no. , pp. 50-51, 1974.
88 ms
(Ver 3.3 (11022016))