Re: Technical writer dream

Subject: Re: Technical writer dream
From: Janice Gelb <janiceg -at- MARVIN -dot- ENG -dot- SUN -dot- COM>
Date: Fri, 18 Jul 1997 08:40:31 -0700

Alexia Prendergast said:
>
> Yes, but if you write a module of conceptual info,
> a module of reference info, and a module of procedural
> info, you can rearrange them as needed for docs
> and help -- no rewriting necessary. And, since less
> info goes into the help, you can just hide the extraneous
> info in each module as needed. There are quite a few
> different ways to do this. (Our audiences are sys
> admins, net admins, and programmers, so we have a
> healthy mix of procedures and reference info.)
>

Many help systems are set up so that the user asks specifically
for task and reference information, which is what I was referring
to below. In that case, reference or conceptual information that
is necessary to do the task would have to be in the task "module"
itself, and having it exist in a separate reference or conceptual
"module" wouldn't help -- you'd still have to slightly rewrite
the task, although the main information could, of course, be
reused. And not all tasks would require such information so
those task "modules" could be reused from print as is.
> >
> >I have found this to be true for task-oriented material, but even then
> >it may need to be rewritten to some extent. In book form, having the
> >concept, task, and reference information for one area (for example, a
> >mail tool) makes the most sense. For online help, however, the task
> >information is going to be entirely separate from the conceptual or
> >reference information, meaning you may have to add context to the task
> >that in the book was present in the preceding or following material.
> >Also, most online help doesn't provide much conceptual information, so
> >you may need to add some concepts to a task screen to orient the user.
>

********************************************************************************
Janice Gelb | The only connection Sun has with this
janice -dot- gelb -at- eng -dot- sun -dot- com | message is the return address.
http://www.geocities.com/Area51/8018/index.html

"The Web is the world's greatest library with all the books on the floor"
-- Patrick Casey, AP (Oklahoma)

********************************************************************************

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html


Previous by Author: Re: Technical writer dream
Next by Author: GUI Documentation
Previous by Thread: Re: Technical writer dream
Next by Thread: Re: Technical writer dream


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


Sponsored Ads