Monthly Archives: January 2014

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

Technical writing and India

India is now well established as a hub for IT. And, unlike other Asian countries India has also been able to reap the benefits of having English as a spoken and official language. This of course means that India was … Continue reading

Posted in Future of tech writing | Tagged , , , , , | Leave a comment

Strunk and White review by Geoffrey K. Pullum

A brillaint review of Strunk and White can be found here. Called 50 Years of Stupid Grammar Advice the author, Geoffrey K. Pullum, pulls no punches. He dissects Elements of Style and shows its many wayward and plainly wrong advice. It also … Continue reading

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

Scientific metaphors

  We don’t use metaphors in technical writing, or at least we don’t think we do. But, are we using dead metaphors? There is a very interesting radio programme on BBC about scientific metaphors and their usage (in fact this whole … Continue reading

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

Hypertext in Framemaker

Is this a quirk of Framemaker? I am not sure. But, anyway here is my experience of using hypertext in Framemaker (unstructured): When I highlight text in a paragraph that I want to act as the link for the hypertext … Continue reading

Aside | Posted on by | Tagged , , , , , , , , , | Leave a comment

Nomadism, open plan offices, and alpha male chimps

Seating arrangements in any office can be tricky. People are very sensitive about where they sit and work and if the conditions are not right their productivity can be greatly affected. I wrote in an earlier post about nomadism for … Continue reading

Posted in Future of tech writing | Tagged , , , , , , , , , , | Leave a comment

Editing: read aloud

When editing and reviewing your own content or someone else’s, there is one tip I can give which I think surpasses all others: read aloud! Spoken word is much older than the written word and it is the rhythms of … Continue reading

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