Tell me… and I will forget. Show me… and I will remember. Involve me… and I will understand. -Confucius Documentation as conversation means getting closer to the users and helping them perform well. Over the years experts such as JoAnn Hackos and Jared Spool have told us that this type of user-centered design and focus […]
Darwin Information Typing Architecture (DITA) reading list
Here’s a reading list for DITA materials when you’re just getting started. I’ve been fielding some questions via email and IM about DITA lately, and pulled this blog post out of my drafts. I hope it’s helpful. Learning more about DITA http://justwriteclick.com/2006/05/18/learning-more-about-dita/ Getting started with DITA http://justwriteclick.com/2007/04/12/getting-started-with-dita/ Structured writing, structured documentation http://www.mbwest.com/Rants-and-raves.htm BMC Case Study […]
Publish a Word outline using Author-it
At ASI, we’re working on book skeletons while we do task analysis for new documentation or feature updates that may change the way users do their work with iMIS. So, to get early feedback, we wanted a way to publish an outline of that skeleton book with no page numbers, but headings and subheading levels […]