Still Greek to Most

PCWorld magazine notes some particularly egregious examples of bad documentation in RTFM: But It's Still Greek to Me.

It's too bad that these examples are such low-hanging fruit. Pointing out typos and bad grammar doesn't take much effort, and it doesn't really help companies improve their documentation. It's documentation that doesn't contain any mechanical errors, but is still completely unusable, that damages the profession more. It's easy for readers to spot when the writer is obviously an amateur, but finely crafted prose often leads readers to feel stupid, instead blaming the educated, but incompetent, author.

Thanks for the pointer, Techwr-L.

Posted: December 19, 2003 link to this item, Tweet this item, respond to this item