Get it in writing, keep it in writing. When you have a face-to-face meeting with a client or project group, take notes. After the meeting, summarize your notes as brief...
Read More
A bug is an undocumented feature There’s an old joke in the software industry: A bug is an undocumented feature. Some software is so beautifully designed with screens that are...
Read More
What makes an expert an expert. I have a friend who defines an expert as “someone who’s made all possible mistakes.” While this is an entertaining definition, I have expanded it: An...
Read More
Words and phrases that just don't work , and then The Microsoft Manual of Style for Technical Publications states that this is acceptable because then is not a coordinate conjunction. However, a...
Read More
Engineer vs. end user and the eighty/twenty rule Engineers are often the worst writers—particularly those engineers who have worked on the product you’ve been hired to document. There’s a great...
Read More
On readability The bottom line on any technical document is whether the user can read, understand and successfully apply the instructions. So how important is readability? Think of it this...
Read More
What I look for in a tech writer Anybody can write a manual, right? I don’t think so. I’ve known a lot of tech writers over the decades I’ve been...
Read More
Pain-free technical manuals Last year, engadget.com published an article with a headline that included “promises ‘service manuals that don’t suck’.” It surprised me that this would be newsworthy–the “promise” from the manufacturer...
Read More
Technical writing and the economy The recession isn’t coming; it’s arrived. Companies are getting more and more budget sensitive, and looking for ways to cut costs. This is impinging on...
Read More
