Reading Usable Help
@UsableHelp on Twitter
Gordon R. Meyer
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.