🚀 go-pugleaf

RetroBBS NetNews Server

Inspired by RockSolid Light RIP Retro Guy

Article View: misc.writing
Article #1311

Re: *** Why is rewriting bad ?

#1311
From: Karen Fegley
Date: Fri, 22 Jan 1993 23:02
27 lines
1474 bytes
In article <1993Jan21.203546.45088@datamark.co.nz> thomas@datamark.co.nz  
(Thomas Beagle) writes:
>
>  . 
>  . 
>  . 
>
> ObWriting : When writing a manual, do you index as you go (and risk
> all sorts of incompatibilities) or do you index after the bulk of the
> manual is written?
> 

If I have my druthers, I wait to index until the bulk of the manual
is written, the draft has been tech reviewed at least once, and I
have incorporated the review comments.  I find that the closer I am
to a complete draft, the more consistent are the index hits that I
insert.  Also, because most of the of the *major* changes have usually
been made to the manual at this point, I spend less time indexing
material that gets dumped anyway and/or going back to index new
material that gets inserted.  (I don't always have my druthers...)

This is just my personal preference.  I know some of the folks around
here swear by the index-as-you-go technique.

Karen Fegley
Stratus Computer, Inc.
kaz@vineland.pubs.stratus.com
Technical Details
Message-ID: <1jpudqINN22g@transfer.stratus.com>
Path: arc1-ca.pugleaf.net!sparky!uunet!noc.near.net!transfer.stratus.com!transfer.stratus.com!usenet
References: <1993Jan21.203546.45088@datamark.co.nz>

Show Full Headers
Complete Article Headers
Path: arc1-ca.pugleaf.net!sparky!uunet!noc.near.net!transfer.stratus.com!transfer.stratus.com!usenet
From: kaz@vineland.pubs.stratus.com (Karen Fegley)
Newsgroups: misc.writing
Subject: Re: *** Why is rewriting bad ?
Date: 22 Jan 1993 23:02:18 GMT
Organization: Stratus Computer Inc, Marlboro MA
Lines: 27
Message-ID: <1jpudqINN22g@transfer.stratus.com>
References: <1993Jan21.203546.45088@datamark.co.nz>
NNTP-Posting-Host: pogo.pubs.stratus.com