Author ncoghlan
Recipients anasofiapaixao, dcbbcd, docs@python, eric.araujo, ezio.melotti, georg.brandl, ncoghlan, rhettinger, terry.reedy
Date 2012-01-28.00:22:41
SpamBayes Score 1.02478e-07
Marked as misclassified No
Message-id <1327710162.55.0.177560790713.issue4966@psf.upfronthosting.co.za>
In-reply-to
Content
Yeah, the basic layout of this entire section has been in place for a *long* time (http://docs.python.org/release/1.4/lib/node4.html#SECTION00310000000000000000)

Some aspects haven't really aged all that well, as people have made minimalist changes to document new features without necessarily stepping back to see if the overall structure still makes sense.

However, rather than dumping one massive patch on python-checkins, I think it makes sense to try to tackle it by section (i.e. sequences + related changes for now, then look at mappings, sets, truth values, comparisons and numbers separately).

One thing I do plan to do is a quick scan for places that reference into the sequence types section to see if they should be adjusted (e.g. see if there's some duplication in the language reference that could be reduced, or cross-references in the glossary to add or update)
History
Date User Action Args
2012-01-28 00:22:42ncoghlansetrecipients: + ncoghlan, georg.brandl, rhettinger, terry.reedy, dcbbcd, ezio.melotti, eric.araujo, docs@python, anasofiapaixao
2012-01-28 00:22:42ncoghlansetmessageid: <1327710162.55.0.177560790713.issue4966@psf.upfronthosting.co.za>
2012-01-28 00:22:41ncoghlanlinkissue4966 messages
2012-01-28 00:22:41ncoghlancreate