TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
> * What criteria do you use to verify if a document is good, in the
> absence of user feedback ?
The only reliable metric I've found has been usability testing,
measuring things like "how many hints do we have to give the
user before they complete a task" and "how long does it take
the user to complete a task."
Often, I discover that my initial concept of "good" was completely
off the mark. For example, for some products, most users consistently
look at only one section of the manual; for them, the quality of that
section IS the quality of the manual. For them, it doesn't matter
whether the other sections are gems of perfection or defect-ridden trash.
Lacking real users, I use surrogate users (anyone I can find who
matches what we think are the important characteristics of real users).
Of course, such testing is expensive (more in terms of time than money),
so I reserve it for precedent-setting documents or for manuals for the
most important products.
Paul
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Free copy of ARTS PDF Tools when you register for the PDF
Conference by May 15. Leading-Edge Practices for Enterprise
& Government, June 3-5, Bethesda,MD. www.PDFConference.com
Check out RoboDemo for tutorials! It makes creating full-motion software
demonstrations and other onscreen support materials easy and intuitive.
Need RoboHelp? Save $100 on RoboHelp Office in May with our mail-in rebate.
Go to http://www.ehelp.com/techwr-l
---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.