RE: IX-nay (was RE: About Responsibility and Fault)

Subject: RE: IX-nay (was RE: About Responsibility and Fault)
From: MList -at- chrysalis-its -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 8 Apr 2003 14:32:47 -0400


John Posada [mailto:JPosada -at- book -dot- com] said:

> >When you hit those kinds of constraints, especially
> >if you are a contractor and don't have "leisure" time
> >between deadlines (ok, everybody stop laughing...),
> >would it be fair to say that things like real indexes
> >are one of the first things to go?
>
> First to go? They never come. Sorry, but I don't index my
> documentation.
> Ever.
>
> My users are fine with keyword text and Boolean searching

Some of us still write docs that are meant to be printed.

I had not been indexing, but when a User Guide reached 400
pages, I thought the lack was becoming a sore spot. The first
pass took nearly a week -- in sharp contrast to some people's
claims that it should take hours or a day-or-two. A mere
concordance wasn't going to cut it.

On the other hand, I think that anything up to 100 pages
that's well organized and is well-served by the ToC, can
probably do without an index.


Hey, your spell-checker reversed my bad pun -- I originally
transposed "liesure", and then left it when I saw that it
implied that I thought "leisure" was a lie, even for us
captive employee types.

/kevin

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Purchase RoboHelp X3 in April and receive a $100 mail-in
rebate, plus FREE RoboScreenCapture and WebHelp Merge Module.
Order here: http://www.ehelp.com/products/robohelp/


Help celebrate TECHWR-L's 10th Anniversary starting this month!
Check out the contests at http://www.raycomm.com/techwhirl/special/contests/
Happy birthday to you, happy birthday to you, happy birthday TECHWR-L....

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



Previous by Author: RE: Antwort: Re: Responsibility, blame, managers, and getting the job done
Next by Author: RE: Who is responsible? (was living doc article)
Previous by Thread: Re: IX-nay (was RE: About Responsibility and Fault)
Next by Thread: RE: IX-nay (was RE: About Responsibility and Fault)


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


Sponsored Ads