Most info architects agree – planning for reuse is harder than conditional text. But even conditional text can be difficult, especially if there are multiple conditions that overlap. The winner of the “most conditional text” contest was this commenter on my talk.bmc post with 64 conditions in a FrameMaker document. Author-it has this to say […]
Find your user’s vocabulary and use his or her key terms as keywords
I just used this “trick” to find out what job titles are relevant for some of the task analysis we’re doing while writing new materials. I think it helps you get into your user’s shoes and also realize the value that your software or hardware product brings to those who decide to become an expert […]
Two panels on wikis and structured authoring such as DITA
There are two upcoming Central Texas DITA User Group meetings that you don’t want to miss if you’re looking into wikis for documentation. Jan. 1/23/08 Ben Allums, Quadralay – wiki.webworks.com Chris Almond, IBM – internal wiki Anne Gentle, OLPC – wiki.laptop.org and www.flossmanuals.net Ragan Haggard, Sun – www.opends.org/wiki Feb. 2/21/08 David Cramer, Motive – internal […]