How to Write a Target Audience Questionnaire
Creating a training plan? Before you do this, you need to step a step back and work out what your colleagues need to learn. Why? Well, otherwise, you risk developing a training plan that overlooks the...
View ArticleAre technical documents a waste of time?
“Don’t worry” she said. “No one reads this stuff anyway. Just get it done.” Sounds familiar? These were the words a former Project Manager once told me. I’d written 20,000 words for a banking system –...
View ArticleHow do you measure the value of technical documents?
One of our tech docs team was fired yesterday. Why? Technical documents provide no value. This is how Management sees it. Tech docs are nice to have but NOT essential. Tech docs are useful but LESS...
View Article10 Best Mistakes I Made in 2009
Fail to prepare, prepare to fail. If you don’t know your mistakes you’re going to repeat them. Here’s my best mistakes. Before we start. Mistakes are things you could have changed. Nothing to do with...
View ArticleDo CEOs Need to Write Well to Succeed?
Thom Haller asks on TCW if ‘to be an effective leader, you need to learn how to write well’. Do You Need to Write Well to Succeed? Here’s how I see it. If you can communicate clearly, then there is a...
View ArticleDoes your writing have an accent?
Maybe you don’t hear your accent, but others do. When you read their documents, does the accent come through? We all judge people by how they speak. It’s easy. When I was a kid, I had a strong regional...
View ArticleMy Ten Favorite Technical Writing Tools
I’ll be honest. I love Microsoft Word! Adobe FrameMaker has it’s moment but, y’know, it’s can be so lame that it beggar’s belief. I’ve used the same technical writing tools for the last 5 years. A few...
View ArticleHow to Setup a Technical Writing Shop On Amazon
You know you spend too much time on the internet when you search for technical writing software and find an Amazon shop for technical writing software… and then realize you built it. And forgot about...
View ArticleAdobe RoboHelp 9 Review
RoboHelp 9, the latest version to be released by Adobe Systems, is being heralded as a major version, so what does it include? One of the big bonuses for new users of RoboHelp is the familiarity of its...
View ArticleContext Sensitive Help: 13 Ways to Test and Improve
After writing the Content Sensitive Help, create a test plan to check that the Help works correctly. Before you start testing the Content Sensitive Help: Clear the cache. Open Excel to log errors....
View Article