The Community for Technology Leaders
Green Image
ABSTRACT
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.
INDEX TERMS
CITATION
Frederick J. Bethke, "Technical writing: Weaving the Silk purse", Computer, vol. 7, no. , pp. 50-51, Nov. 1974, doi:10.1109/MC.1974.6323355
95 ms
(Ver )