Re: Documenting "touchy" applications?

Subject: Re: Documenting "touchy" applications?
From: John Posada <jposada01 -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 18 Mar 2002 10:24:06 -0800 (PST)

Its not a case of the user not following the process and coming up
with erros, but more of a case of the following...I wsas tryint to
come up with an example that applies....this is the closest that I

Imaging Windows98 Explorer..not the Internet browser, but the file

There's a left and right pane.

Here's what the developer might want:

1) To launch a file, find the root directory in the left pane and
double click on it.
2) In the list of subdirectories in the left pane, click the next
3) In the list of subdirectories in the left panhe, click the next
4) Repeat this process until the application you want to launch is
displayed in the right pane.
5) In the right pane, double-click the EXE file and the application

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?

John Posada, Senior Technical Writer
Current gig ending 4/15
mailto:john -at- tdandw -dot- com, 732-259-2874

Do You Yahoo!?
Yahoo! Sports - live college hoops coverage

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
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.


Documenting "touchy" applications?: From: Hart, Geoff

Previous by Author: Documenting "touchy" applications
Next by Author: Re: Documenting "touchy" applications? (take II)
Previous by Thread: Documenting "touchy" applications?
Next by Thread: Re(2): Documenting "touchy" applications?

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

Sponsored Ads

Sponsored Ads