Category Archives: Tools

Readability tests

I once had a colleague/SME asking me if I used readability tests for checking the technical documentation. “Something like Flesch-Kincaid” he said. I had no idea what he was talking about. It sounded sinister with the name ‘Flesch-Kincaid’ and I … Continue reading

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

God is a technical writer

The ten commandments is possibly the most famous piece of technical writing in the western world and it was written by God himself (or so you might believe if you are a member of one of the Judeo-Christian religions). The … Continue reading

Posted in DITA, Tools, 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

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

Adobe Framemaker 11 and XML

Will there come a day when Framemaker is not synonymous with technical writing? Yes. Has that day arrived? Possibly. Framemaker has been the tool of choice for a lot of technical documentation teams over the past decade, and is still … Continue reading

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