[Python-Dev] Moving the developer docs?
g.brandl at gmx.net
Thu Sep 23 18:21:51 CEST 2010
Am 23.09.2010 16:47, schrieb Guido van Rossum:
> On Thu, Sep 23, 2010 at 7:35 AM, Barry Warsaw <barry at python.org> wrote:
>> On Sep 23, 2010, at 10:06 AM, Jesse Noller wrote:
>>>-1 on wiki; wikis are where good information goes off to die.
>> Well, *all* documentation requires vigilance to remain relevant and current.
>> I'm sure you don't think the Python wiki is useless, right? ;)
> I have to agree with Jesse. We have too many wiki pages that are so
> out of date they're dangerous. They serve a purpose, and I think we
> should have a wiki in addition to the "official" documentation. This
> could be aggressively linked from it so people can comment on that
> documentation -- a commenting system like the PHP docs have would be
> even better, but that's been an unimplemented idea for so long that
> I'm not holding my hopes up.
You should read my tweets more often :)
Yes, I know I promised this for last year, but this time the code is already
merged, and I "just" need to polish and set it up on docs.python.org.
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