classification
Title: Documentation on website is missing section numbers
Type: performance Stage:
Components: Documentation Versions: Python 2.6
process
Status: closed Resolution: duplicate
Dependencies: Superseder:
Assigned To: georg.brandl Nosy List: georg.brandl, ivazquez
Priority: normal Keywords:

Created on 2008-10-06 16:36 by ivazquez, last changed 2008-10-08 16:44 by georg.brandl. This issue is now closed.

Messages (2)
msg74381 - (view) Author: Ignacio Vazquez-Abrams (ivazquez) Date: 2008-10-06 16:36
The documentation on the website seems to have lost the numbers
identifying the various sections. It was useful to point a user to e.g.
ยง3.6.2 of the libref in order to guide them to the string interpolation
documentation. This is now no longer possible, and instead the user must
hunt around for the appropriate section. This is a severe usability hit
against the documentation.
msg74532 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2008-10-08 16:44
I disagree that missing section numbers are a severe usability hit.
Especially in the context that the new docs are constantly updated,
there's no telling when section numbers will shift, misleading those who
only navigate by section number. In contrast, a link is persistent and
usually also quicker to get to.

That said, I acknowledge the wish for section numbers, and there is an
issue entry about it in the tracker for the Sphinx project, which is
used to build the new docs, at <http://code.google.com/p/sphinx>.

Closing this one as duplicate.
History
Date User Action Args
2008-10-08 16:44:58georg.brandlsetstatus: open -> closed
resolution: duplicate
messages: + msg74532
2008-10-06 16:36:34ivazquezcreate