Python docs bug

Discussion in 'Python' started by Lawrence D'Oliveiro, Jun 29, 2006.

  1. One long-standing irritation I have with the table of contents for the
    Python Library Reference <http://docs.python.org/lib/lib.html>, is that
    there is one very important section, "String Methods"
    <http://docs.python.org/lib/string-methods.html>, which does not appear
    there. That's because it is section 2.3.6.1, and the table of contents
    only goes to 3 levels.
     
    Lawrence D'Oliveiro, Jun 29, 2006
    #1
    1. Advertising

  2. Lawrence D'Oliveiro

    John Roth Guest

    Lawrence D'Oliveiro wrote:
    > One long-standing irritation I have with the table of contents for the
    > Python Library Reference <http://docs.python.org/lib/lib.html>, is that
    > there is one very important section, "String Methods"
    > <http://docs.python.org/lib/string-methods.html>, which does not appear
    > there. That's because it is section 2.3.6.1, and the table of contents
    > only goes to 3 levels.


    I've found that to be quite irritating as well.
    That's the section I use the most, and I find
    it irritating that I have to drill down into the
    manual every time to find it.

    I wouldn't call it a bug though. I'd call it an
    example of pedantry over usability.

    John Roth
     
    John Roth, Jun 29, 2006
    #2
    1. Advertising

  3. Lawrence D'Oliveiro

    Guest


    >> One long-standing irritation I have with the table of contents for
    >> the Python Library Reference <http://docs.python.org/lib/lib.html>,
    >> is that there is one very important section, "String Methods"
    >> <http://docs.python.org/lib/string-methods.html>, which does not
    >> appear there. That's because it is section 2.3.6.1, and the table of
    >> contents only goes to 3 levels.


    John> I've found that to be quite irritating as well.

    Maybe someone should submit a bug report on SF...

    Skip
     
    , Jun 29, 2006
    #3
  4. Lawrence D'Oliveiro

    Terry Reedy Guest

    <> wrote in message
    news:...
    >
    > >> One long-standing irritation I have with the table of contents for
    > >> the Python Library Reference <http://docs.python.org/lib/lib.html>,
    > >> is that there is one very important section, "String Methods"
    > >> <http://docs.python.org/lib/string-methods.html>, which does not
    > >> appear there. That's because it is section 2.3.6.1, and the table

    > of
    > >> contents only goes to 3 levels.

    >
    > John> I've found that to be quite irritating as well.


    Me too

    > Maybe someone should submit a bug report on SF...


    done
    www.python.org/sf/1514540

    Terry Jan Reedy
     
    Terry Reedy, Jun 29, 2006
    #4
    1. Advertising

Want to reply to this thread or ask your own question?

It takes just 2 minutes to sign up (and it's free!). Just click the sign up button to choose a username and then you can ask your own questions on the forum.
Similar Threads
  1. KYG
    Replies:
    2
    Views:
    898
    Ian Collins
    Aug 18, 2008
  2. Brandon Craig Rhodes

    python docs redirect on python.org is old

    Brandon Craig Rhodes, Apr 5, 2009, in forum: Python
    Replies:
    2
    Views:
    265
    barisa
    Apr 5, 2009
  3. Stéphane Wirtel
    Replies:
    0
    Views:
    188
    Stéphane Wirtel
    Apr 19, 2007
  4. Al
    Replies:
    1
    Views:
    156
    Henry Law
    Oct 16, 2005
  5. Xavier Ho
    Replies:
    0
    Views:
    146
    Xavier Ho
    Feb 1, 2013
Loading...

Share This Page