Nick Coghlan <ncogh...@gmail.com> added the comment:

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)

----------

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue4966>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to