Re: my bad displays habit

Subject: Re: my bad displays habit
From: "Karen L. Zorn" <k -dot- zorn -at- zorntech -dot- com>
Date: Tue, 02 Mar 2010 15:55:55 -0700

A long time ago in a state far, far away, I wrote course ware for those brand new personal computers, starting with the Apple IIe, Kapro, and eventually the chicklet PC. The courses were published on audio cassettes with a handy-dandy quick reference guide. As part of our QA, all scripts were recorded by the authors, then tested by live, naive students. It quickly became apparent that you must keep in mind where the learner is and what they should see on the monitor.

That do-this, this-happens (or you see this) habit has continued to this day, some 30 years later. Yes, you can go overboard, but I'd rather have procedures that support the user than to leave them guessing, frustrated, and in the end angry with your product.

Karen Zorn
ZornTech LLC

Suzanne Chiles wrote:


We always assume our readers will read every word we say and perform the
task exactly as we described. I don't think that's fair assumption in the
real world. At least having a step result lets the user know if they're on
the right track or not.



Use Doc-To-Help's XML-based editor, Microsoft Word, or HTML and
produce desktop, Web, or print deliverables. Just write (or import)
and Doc-To-Help does the rest. Free trial:

Explore CAREER options and paths related to Technical Writing,
learn to create SOFTWARE REQUIREMENTS documents, and
get tips on FUNCTIONAL SPECIFICATION best practices. Free at:

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Please move off-topic discussions to the Chat list, at:


Re: my bad displays habit: From: Mike Starr
Re: my bad displays habit: From: Suzanne Chiles

Previous by Author: Re: Which would you prefer and why? (Help Tool)
Next by Author: Re: OT: Profanity in the workplace
Previous by Thread: Re: my bad displays habit
Next by Thread: Re: my bad displays habit

What this post helpful? Share it with friends and colleagues:

Sponsored Ads