Tag Archives: process

My plain English might not be your plain English

There are a lot of words that are known to only specialists and can make non-specialists feel like outsiders. The Plain English Campaign in the UK and its sister organisations in other countries tries to confront the problem of specialist … Continue reading

Posted in Style Guide, Usability studies | Tagged , , , , , , , , , , | Leave a comment

Machiavelli for tech writers

  Tina the tech writer could have done with a bit less passive aggression and a bit more canniness. The muttering, grumbling tech writer who is forever being overruled touches a chord with a lot of people in our profession. … Continue reading

Posted in Tech writer tips | Tagged , , , , , , , , , , | Leave a comment

DITA and CMS overview

DITA has been around awhile now, but is not universally used by technical documentation teams. However, it has become the most popular standard in structured formats for technical writing, overtaking the likes of Docbook. I suppose one of the main … Continue reading

Posted in DITA | Tagged , , , , , , , , , , , , , , | Leave a comment

Language use: act like a baby and treat others like one too

Maybe it seems like I am being puerile with the title or going to mention something about always using the lowest common denominator when thinking of your audience. But, not at all; the opposite in fact. It’s in infancy when … Continue reading

Posted in Style Guide, Tech writer tips, Usability studies | Tagged , , , , , , , , , , , , , , | Leave a comment

Creating a new style

So, you now know you have at least two styles that you want to create. How do you go about implementing them? How do you document your styles and keep track that styles are being used correctly? If you have … Continue reading

Posted in Style Guide, Tech writer tips, Usability studies | Tagged , , , , , , , , | Leave a comment

Style Guide: weakening the power of words

What do we do as tech writers? We write words for a living. But, what type of words? What type of strength do those words contain? Is it that the task of the words we write is simply to describe the … Continue reading

Posted in Future of tech writing, Style Guide, Tech writer tips, Tools, Usability studies | Tagged , , , , , , , , , | Leave a comment

Mona Lisa smile

Back on the subject of how part of our job as technical writer’s is to ask questions about the projects we work on. In 1911, the Mona Lisa was stolen and it took a whole day before anyone realised something … Continue reading

Posted in Tech writer tips, Usability studies | Tagged , , , , , , , | Leave a comment