-----BEGIN PGP SIGNED MESSAGE----- On Mon, 31 Mar 1997 23:22:44 -0500 (EST), da@maigret.cog.brown.edu writes:
I don't like writing documentation much, and indexing is the most boring part of documentation :-( So any help here would be appreciated. The best way to index, I've been told, is for someone to make a separate pass over the complete text when it's finished. (However, O'Reilly did this for PP and the resulting index in the first printing is considered somewhat lacking by most.)
In this case, it might be possible to use technology -- we could ask the python-list readers (and tchrist, why not =) to email a list of terms they would want to an automatic email processing system which could remove duplicates -- it might yield some 'collective insight' -- I especially think that the input of novices is most useful for this kind of thing (assuming that the input of experts is included as a matter of course).
Even better, some way for people to add concepts (and associated page references) that should be indexed. That would probably require a human editor, though. [A copy of the headers and the PGP signature follow.] Date: Tue, 01 Apr 1997 08:00:50 -0600 From: "Jeffrey C. Ollie" <jeff@ollie.clive.ia.us> In-reply-to: Your message of "Mon, 31 Mar 1997 23:22:44 EST." <Pine.SGI.3.95q.970331231740.26053A-100000@maigret> Subject: Re: [PYTHON DOC-SIG] Documentation enhancements To: doc-sig@python.org -----BEGIN PGP SIGNATURE----- Version: 2.6.2 Comment: AnySign 1.4 - A Python tool for PGP signing e-mail and news. iQCVAwUBM0EVFpwkOQz8sbZFAQE30AP/SN6p8NptFrx5BSfEfYJX8+WRV5Xr6LKb +ITP7w/ZVLnalUF8QgX3hdyonzF+FNI1mtvS3t8o93Y1DgZtsQwcJCUmp9uIYElr OBl2akoX6a7GkcDttdpI/h82MajBa79rRi8BTulLkSjF/z/NjUQqbB8gyfmXPbsN S8vfNtjb76U= =3Xox -----END PGP SIGNATURE----- -- Jeffrey C. Ollie | Should Work Now (TM) Python Hacker, Mac Lover | _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig@python.org administrivia to: doc-sig-request@python.org _______________