[PYTHON DOC-SIG] Documentation enhancements

Andrew Kuchling amk@magnet.com
Mon, 31 Mar 1997 17:34:25 -0500 (EST)

I've found a publisher who's somewhat interested in producing a
printed version of the Python docs, though nothing is certain yet.  In
the knowledge that there may be a printed version of the 1.5 docs,
what changes should be made?  

Gabriel Berriz made some excellent suggestions, where the priority is
improving the index and adding cross-references from module to module.
(For example, the rand module would also reference random.py and
whrandom.py.  Michael K. Johnson at Red Hat independently suggested
the same improvement.)

Regarding a printed version, what should be in it?  Probably the big 4
should all be included: library, reference, extension manual, and
tutorial.  (Or can the tutorial be left out?  I'd vote no, but...)
Are there other documents that should be included?  Possibilities:

	* qua.tex
	* The man page for the Python interpreter
	* Documentation for the matrix extensions?  PIL?  Something
	* Is there Windows or Mac documentation that could/should be

	Andrew Kuchling
Save the Gutenberg Project! http://www.promo.net/pg/nl/pgny_nov96.html

DOC-SIG  - SIG for the Python Documentation Project

send messages to: doc-sig@python.org
administrivia to: doc-sig-request@python.org