Tag Archives: technical writer

Serial comma (Oxford comma)

  Commas seem to cause a lot of dismay among writers and subs generally. Their purpose, how they work, where to place them seems to cause unending consternation. I think that might be one reason there is some hostility to … Continue reading

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

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

Creating headers in Ditamaps

I found it difficult to find relevant information on the web about how to create anything below a level-heading 2. In my Ditamaps the heading 2 is the topic level and therefore, as soon as a topic is added to … Continue reading

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

Latin abbreviations in technical writing

Many style guides as well as simplified English and plain English campaigners share a common goal of wanting to eradicate Latin loan-words from English, and this includes Latin abbreviations. This post from a 2012 entry on ferswriteshoe blog is nice … Continue reading

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

Hiring a tech writer: cross-over skills

Hiring someone with the right skills for a position of technical writer can be difficult. The job is more diverse these days and cannot be merely pigeon-holed as ‘manual-writer’. In fact, the skills and expertise needed between one tech writer … Continue reading

Posted in Hiring a tech writer | Tagged , , , , , , , , , | Leave a comment

Thomas Pynchon: tech writer and fictional writer

As a technical writer it is refreshing to see that the experiences you have in the profession can be made into works of art. Case in point: V. and The Crying of Lot 49 by Thomas Pynchon. Interestingly, the only … Continue reading

Posted in Books | 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