Python docs bug

[Lawrence D'Oliveiro]

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 Roth]

Re: Python docs bug


Lawrence D'Oliveiro wrote:[color=blue]
> 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.[/color]

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

[skip@pobox.com]

Re: Python docs bug

[color=blue][color=green]
>> 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.[/color][/color]

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

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

Skip

[Terry Reedy]

Re: Python docs bug


<skip@pobox.com > wrote in message
news:17571.6084 5.33044.994034@ montanaro.dyndn s.org...[color=blue]
>[color=green][color=darkred]
> >> 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[/color][/color]
> of[color=green][color=darkred]
> >> contents only goes to 3 levels.[/color][/color]
>
> John> I've found that to be quite irritating as well.[/color]

Me too
[color=blue]
> Maybe someone should submit a bug report on SF...[/color]

done

https://www.python.org/sf/1514540

Terry Jan Reedy