Re(2): Documenting "touchy" applications?

Subject: Re(2): Documenting "touchy" applications?
From: Jan Henning <henning -at- r-l -dot- de>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 18 Mar 2002 19:54:17 +0100

>Now, supposed the user was to click the subdirectoriesd in the right
>pane to get to the file. To the developer, this would not be the
>right way to do it and the program should generate an error message.
>Do I document that the user must only do it from the left pane and
>that if they do it from the right, the results are not guaranteed?

The first thing you should try, IMHO, is to get the developers to do it
right. 'Right' in this case is that any reasonable expectation the user
has should be fulfilled, and if the user wants to open a directory, he or
she can reasonably expect to be able to do so in either half of the window.

_Only_ if the developers are unwilling or unable to fix the bug (because
what you describe is a bug) should you warn the user.

Jan Henning

Jan Henning
Am Schlossberg 14, D-82547 Eurasburg, Germany

Phone: +49 700 0200 0700, Fax: +49 81 79 93 07 12
E-Mail: henning -at- r-l -dot- de, Web:
Handelsregister: München HRB 99345

PC Magazine gives RoboHelp Office 2002 five stars - a perfect score!
"The ultimate developer's tool for designing help systems. A product
no professional help designer should be without." Check out RoboHelp at

Check out the TECHWR-L Site redesign!

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 for more resources and info.


Re: Documenting "touchy" applications?: From: John Posada

Previous by Author: Re(2): is it really that uncommon?
Next by Author: Re: Intranet Problem
Previous by Thread: Re: Documenting "touchy" applications?
Next by Thread: Re: Documenting "touchy" applications?

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

Sponsored Ads