RE: Documenting installers

Subject: RE: Documenting installers
From: "John Posada" <JPosada -at- isogon -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 20 May 2004 12:03:28 -0400


Dana...this is an instance where when I read "your" documentation for an
install, I think "I wish I knew what was happening at each screen." and
when you read mine, you think "blah blah blah...all this wasted time and
paper to describe pressing a series of buttons."

I wish I knew for certain who was right. :-)

John Posada
Senior Technical Writer
Isogon Corporation
http://www.isogon.com
"Realizing Your Business Goals
Through Software Asset Management"

-----Original Message-----
From: bounce-techwr-l-143723 -at- lists -dot- raycomm -dot- com
[mailto:bounce-techwr-l-143723 -at- lists -dot- raycomm -dot- com] On Behalf Of Dana
Worley
Sent: Thursday, May 20, 2004 11:54 AM
To: TECHWR-L
Subject: Re: Documenting installers


On Wednesday, May 19, 2004, Norcross, Amanda wrote:

> My question is the following: does it make more sense in an
> installation procedure to: 1) "gloss over" these common windows and
> only address in detail windows that are unique or specific to our
> product or 2) address all windows, regardless of how many million
> times users may have seen some of them. #

I usually leave it at "follow the prompts on the screen".


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

SEE THE ALL NEW ROBOHELP X5 IN ACTION: RoboHelp X5 is a giant leap forward
in Help authoring technology, featuring Word 2003 support, Content
Management, Multi-Author support, PDF and XML support and much more! http://www.macromedia.com/go/techwrldemo

>From a single set of Word documents, create online Help and printed
documentation with ComponentOne Doc-To-Help 7 Professional, a new yearly
subscription service offering free updates and upgrades, support, and more.
http://www.doctohelp.com

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -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:

Previous by Author: RE: Documenting installers?
Next by Author: XP Toolbar Buttons
Previous by Thread: Re: Documenting installers
Next by Thread: Re: Documenting installers


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


Sponsored Ads