home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #3 / NN_1993_3.iso / spool / misc / writing / 4235 < prev    next >
Encoding:
Internet Message Format  |  1993-01-23  |  1.4 KB
  1. Path: sparky!uunet!noc.near.net!transfer.stratus.com!transfer.stratus.com!usenet
  2. From: kaz@vineland.pubs.stratus.com (Karen Fegley)
  3. Newsgroups: misc.writing
  4. Subject: Re: *** Why is rewriting bad ?
  5. Date: 22 Jan 1993 23:02:18 GMT
  6. Organization: Stratus Computer Inc, Marlboro MA
  7. Lines: 27
  8. Message-ID: <1jpudqINN22g@transfer.stratus.com>
  9. References: <1993Jan21.203546.45088@datamark.co.nz>
  10. NNTP-Posting-Host: pogo.pubs.stratus.com
  11.  
  12. In article <1993Jan21.203546.45088@datamark.co.nz> thomas@datamark.co.nz  
  13. (Thomas Beagle) writes:
  14. >
  15. >  . 
  16. >  . 
  17. >  . 
  18. >
  19. > ObWriting : When writing a manual, do you index as you go (and risk
  20. > all sorts of incompatibilities) or do you index after the bulk of the
  21. > manual is written?
  22. > 
  23.  
  24. If I have my druthers, I wait to index until the bulk of the manual
  25. is written, the draft has been tech reviewed at least once, and I
  26. have incorporated the review comments.  I find that the closer I am
  27. to a complete draft, the more consistent are the index hits that I
  28. insert.  Also, because most of the of the *major* changes have usually
  29. been made to the manual at this point, I spend less time indexing
  30. material that gets dumped anyway and/or going back to index new
  31. material that gets inserted.  (I don't always have my druthers...)
  32.  
  33. This is just my personal preference.  I know some of the folks around
  34. here swear by the index-as-you-go technique.
  35.  
  36. Karen Fegley
  37. Stratus Computer, Inc.
  38. kaz@vineland.pubs.stratus.com
  39.