This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: LibRef: reworked chapter organization
Type: Stage:
Components: Documentation Versions:
process
Status: closed Resolution: accepted
Dependencies: Superseder:
Assigned To: akuchling Nosy List: akuchling, spencermah
Priority: normal Keywords: patch

Created on 2005-12-07 15:31 by akuchling, last changed 2022-04-11 14:56 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
lib.patch akuchling, 2005-12-07 15:31 Patch for lib.tex
lib.tex akuchling, 2005-12-07 15:33 Modified lib.tex file
lib.tex akuchling, 2005-12-08 14:43 Michael Spencer's further reorganization
Messages (5)
msg49180 - (view) Author: A.M. Kuchling (akuchling) * (Python committer) Date: 2005-12-07 15:31
The attached patch is a first cut at reorganizing the
chapters of the Library Reference.

Three chapters are currently very large: "Miscellaneous
Services", 'Generic OS Services' and 'Optional OS
Services'. These chapters are broken up into smaller
and more focused chapters such as 'file system
services' and 'interprocess communication'.

This patch isn't ready to be applied yet; I want
feedback on the chapter organization before finishing
it.  Still to do:

 * Write introductory paragraphs for all of the new
chapters
 * Re-order chapters roughly by importance; this patch
creates them in a random order.

Difficult corner cases: where should the logging,
itertools, functional modules go?  The patch leaves
them in 'Miscellaneous'.
msg49181 - (view) Author: A.M. Kuchling (akuchling) * (Python committer) Date: 2005-12-07 15:33
Logged In: YES 
user_id=11375

Attaching a copy of the modified lib.tex file; it's probably
easier to figure out the new organization by reading this
file than by reading the patch.

msg49182 - (view) Author: MIchael Spencer (spencermah) Date: 2005-12-07 22:37
Logged In: YES 
user_id=1399606

I tried a further re-organization.  Results at:

http://groups.google.com/group/comp.lang.python/msg/4220f6896602c03c?hl=en&;
msg49183 - (view) Author: A.M. Kuchling (akuchling) * (Python committer) Date: 2005-12-08 14:43
Logged In: YES 
user_id=11375

Attaching a copy of Michael Spencer's reorganization
msg49184 - (view) Author: A.M. Kuchling (akuchling) * (Python committer) Date: 2005-12-22 20:38
Logged In: YES 
user_id=11375

Applied in rev41797.
History
Date User Action Args
2022-04-11 14:56:14adminsetgithub: 42666
2005-12-07 15:31:52akuchlingcreate