[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
else?
* Is there Windows or Mac documentation that could/should be
included?
Andrew Kuchling
amk@magnet.com
http://people.magnet.com/%7Eamk/
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
_______________