Re: [Python-Dev] Python Library Reference top page too long

2006-03-18 Thread Aahz
On Fri, Mar 17, 2006, Georg Brandl wrote: > Greg Ewing wrote: >> Russell E. Owen wrote: >>> >>> Another thing that would be *really* useful is to list the actual >>> built-in types with the category. For example: >>> Sequence Types (str, unicode, list, tuple, buffer, xrange) >>> Mapping Types (di

Re: [Python-Dev] Python Library Reference top page too long

2006-03-17 Thread Russell E. Owen
In article <[EMAIL PROTECTED]>, Georg Brandl <[EMAIL PROTECTED]> wrote: > >> Another thing that would be *really* useful is to list the actual > >> built-in types with the category. For example: > >> Sequence Types (str, unicode, list, tuple, buffer, xrange) > >> Mapping Types (dict) > > > > +1

Re: [Python-Dev] Python Library Reference top page too long

2006-03-16 Thread Georg Brandl
Greg Ewing wrote: > Russell E. Owen wrote: > >> Fundamentally I think what's wanted is: >> - Another level of sub-TOCs, e.g. one for "Sequence Types", "Mapping >> Types", etc. Every page that has sub-topics or intimately related should >> have a list of them at the beginning. >> - The special me

Re: [Python-Dev] Python Library Reference top page too long

2006-03-16 Thread Greg Ewing
Russell E. Owen wrote: > Fundamentally I think what's wanted is: > - Another level of sub-TOCs, e.g. one for "Sequence Types", "Mapping > Types", etc. Every page that has sub-topics or intimately related should > have a list of them at the beginning. > - The special methods for a given type of c

Re: [Python-Dev] Python Library Reference top page too long

2006-03-16 Thread Edward Loper
Martin v. Löwis wrote: > Edward C. Jones wrote: >> The contents page for the Python Library Reference >> ("http://docs.python.org/dev/lib/lib.html";) has become much too long. > > I disagree. It serves my purposes very well: I usually search in the > page for a keywork I think should be there. If

Re: [Python-Dev] Python Library Reference top page too long

2006-03-16 Thread Russell E. Owen
In article <[EMAIL PROTECTED]>, "Edward C. Jones" <[EMAIL PROTECTED]> wrote: > The contents page for the Python Library Reference > ("http://docs.python.org/dev/lib/lib.html";) has become much too long. I > suggest that it should be designed like the top page for portal web > sites. For exampl

Re: [Python-Dev] Python Library Reference top page too long

2006-03-16 Thread Martin v. Löwis
Edward C. Jones wrote: > The contents page for the Python Library Reference > ("http://docs.python.org/dev/lib/lib.html";) has become much too long. I disagree. It serves my purposes very well: I usually search in the page for a keywork I think should be there. If the page was broken into multipl

[Python-Dev] Python Library Reference top page too long

2006-03-16 Thread Edward C. Jones
The contents page for the Python Library Reference ("http://docs.python.org/dev/lib/lib.html";) has become much too long. I suggest that it should be designed like the top page for portal web sites. For example see "http://www.dmoz.org/";. I suggest that "lib.html" be replaced by "lib_index.htm