Cloze Test of Document Comprehensibility
How comprehensible is your technical document? There are various tests and measures of comprehensibility but I like the Cloze Test the best since it measures the interactivity of the user with the document within a specific subject-matter context. The test is nothing new. It was first formulated by W. L. Taylor in 1953. It consists…
Read MoreHow to Compare Multiple Outputs of RoboHelp and FrameMaker
I’ve made a test to compare Multiple Outputs of RoboHelp and FrameMaker. I generated different output versions of the same simple file both by using Adobe FrameMaker and then Adobe RoboHelp. Since these two great products are sold as part of Adobe’s Technical Communication Suite, I wanted to see what would one lose without RoboHelp…
Read MoreHow to Insert a Proper Page Break for Changing Page Orientation in MS Word
In MS Word, not all page breaks are the same. The two different types of page breaks have different repercussions when it comes to changing your page layout in mid-stream. You have to be careful what kind of a page break you are inserting if you would like to change your page layout orientation from…
Read MoreWriting with Short Words to Save Space on Mobile Platforms
© Ugur Akinci When writing for small-screen mobile platforms like smart phones and pads the real estate is at a premium. The screens are so small, the technical writers must express procedures by using as short words and phrases as possible. Here is the screen provided by Joe Welinske during an STC Washington D.C. Baltimore…
Read More