[PYTHON DOC-SIG] Documentation enhancements

Jeffrey C. Ollie jeff@ollie.clive.ia.us
Tue, 01 Apr 1997 08:00:50 -0600


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."
Subject: Re: [PYTHON DOC-SIG] Documentation enhancements 
To: doc-sig@python.org

Version: 2.6.2
Comment: AnySign 1.4 - A Python tool for PGP signing e-mail and news.

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