[Python-Dev] [Python-3000] Documentation switch imminent

Thomas Wouters thomas at python.org
Tue Aug 21 10:23:51 CEST 2007


On 8/14/07, Georg Brandl <g.brandl at gmx.net> wrote:
>
> Now that the converted documentation is fairly bug-free, I want to
> make the switch.


One thing I miss (and I haven't followed the discussions about the new
layout at all, so I don't know if it came up already) is section numbers. I
very often refer people to "Section 4.7 of the tutorial at
docs.python.org/tut" or "Appendix B of the tutorial" or "Section 3.6.2 of
the library reference", which the new layout doesn't exactly permit. I also
think the index and section headers are less clear, more chaotic, without
the numbering. Any chance we can get something like it back? :)

-- 
Thomas Wouters <thomas at python.org>

Hi! I'm a .signature virus! copy me into your .signature file to help me
spread!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.python.org/pipermail/python-dev/attachments/20070821/23e2da63/attachment.htm 


More information about the Python-Dev mailing list