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

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

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
subdirectory.
3) In the list of subdirectories in the left panhe, click the next
subdirectory.
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
launches.

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
Resume: http://www.tdandw.com/Resume_Posada_022202.doc
mailto:john -at- tdandw -dot- com, 732-259-2874

__________________________________________________
Do You Yahoo!?
Yahoo! Sports - live college hoops coverage
http://sports.yahoo.com/

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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
http://www.ehelp.com/techwr
---
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.



Follow-Ups:

References:
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