[PYTHON DOC-SIG] Documentation enhancements

[Jeffrey C. Ollie]

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