[Python-Dev] [Python-3000] Documentation switch imminent
g.brandl at gmx.net
Tue Aug 21 15:40:00 CEST 2007
Thomas Wouters schrieb:
> On 8/14/07, *Georg Brandl* <g.brandl at gmx.net <mailto:g.brandl at gmx.net>>
> 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 <http://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? :)
You're right, it can be helpful. I'll look into it, how much work it
probably would be.
Thus spake the Lord: Thou shalt indent with four spaces. No more, no less.
Four shall be the number of spaces thou shalt indent, and the number of thy
indenting shall be four. Eight shalt thou not indent, nor either indent thou
two, excepting that thou then proceed to four. Tabs are right out.
More information about the Python-Dev