The guilty pleasure of writing policy and procedure documents

We have a number of projects running at the moment that involve us improving organisations’ policy and procedures documents. It may not seem likely, but these projects are enormous fun. The best analogy I can find is that it’s like rearranging someone else’s record collection. Or in a more modern setting, it’s like creating a… Read more »

Technical writing in the Cloud

One of the most popular developments in computing in recent years has been the emergence of cloud-based computing and Software as a Service (SaaS). Examples of cloud-based computing include Google’s GMail: Instead of an application being installed locally on a user’s computer, it runs on a remote server, accessed via the user’s Web browser. So is technical… Read more »

New – Technical Writer induction course

Yesterday, we launched our online Technical Writer induction course. This online course covers the technical documentation process and the skills you need in order to be a successful Technical Writer or Technical Author. Created by the authors of the popular “How to Write Instructions” book, this 14 module course explains the technical communicator’s role in… Read more »

Is most beginner technical writing training out of touch with the real world?

In developing our new Technical author basic/induction training course modules, one thing that struck us was it is easy to talk about a technical writing process that is often not followed in reality. For example, most books on technical writing describe how the writing project begins with a planning stage, an activity where the project is… Read more »

Writing user documentation collaboratively in an Agile environment

Hi, You provide wonderful newsletters full of useful information. Thank you. I’m a Senior Technical Writer in a small company, and I have one contractor working for me. We have come up against a challenge. <snip>… My team currently uses RoboHelp, which is not a collaborative, team tool for writing. The company likes to think… Read more »