Feel free to send patches, as small as they may seem. Mark up PEP numbers in reST like this -- :pep:`42` -- to get automatic linking. Georg Shawn Ligocki schrieb:
+2, Sign me up.
The "why" is the most annoyingly avoided question in teaching anything.
If someone leads this, I'll help contribute!
Cheers,
Shawn Ligocki sligocki@gmail.com <mailto:sligocki@gmail.com>
On Mon, Mar 16, 2009 at 10:25 AM, Zac Burns <zac256@gmail.com <mailto:zac256@gmail.com>> wrote:
I would like to see links to relevant PEP / mailing list docs in the main docs.
For example http://docs.python.org/library/dircache.html after "Deprecated since version 2.6" could include a (PEP x.x) link where I could read why it was deprecated and probably what to use in it's place.
The docs right now are quite excellent describing the "what" about everything, but often have little to say about the "why". This is a good thing, but links would surely help those that want to learn more.
-- Zachary Burns (407)590-4814 Aim - Zac256FL Production Engineer (Digital Overlord) Zindagi Games _______________________________________________ Python-ideas mailing list Python-ideas@python.org <mailto:Python-ideas@python.org> http://mail.python.org/mailman/listinfo/python-ideas
------------------------------------------------------------------------
_______________________________________________ Python-ideas mailing list Python-ideas@python.org http://mail.python.org/mailman/listinfo/python-ideas
-- 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.