Context 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. Don’t test your own work. How to Test Content Sensitive Help Use this checklist to test the Content Sensitive Help: F1 — […]

Adobe 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?

How 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 it! Yes, this is what happened to me yesterday. Maybe I need to slow down because…

My 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 products have come across my desk but nothing that really blown me away. Here’s a run-down of what I use to write my technical documents. No order of preference. Which should I keep? Which should I replace?

Does 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?

Do 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’.

10 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.

How 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 important than development, user interface and marketing. Are they right? It’s hard not to get defensive in these situations. […]

Are 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 – and no-one would read it. What do you do when your own company has such a poor view of […]

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.