[Python-ideas] Linking Doug's stdlib documentation to our main modules doc.

Georg Brandl g.brandl at gmx.net
Sat Mar 19 19:02:00 CET 2011


On 19.03.2011 18:27, Jesse Noller wrote:
> On Fri, Mar 18, 2011 at 6:29 PM, Guido van Rossum <guido at python.org> wrote:
>> On Fri, Mar 18, 2011 at 1:48 PM, Ian Bicking <ianb at colorstudy.com> wrote:
>>> On Thu, Mar 17, 2011 at 8:47 PM, Steven D'Aprano <steve at pearwood.info>
>>> wrote:
>>>> With all respect to Doug, do we really want to bless his website more than
>>>> any of the other Python blogs, tutorials, etc. out on the Internet?
>>>
>>> Bah humbug.  If we could link stdlib docs to every good quality piece of
>>> coverage for that module then that would be great.  It's not like someone
>>> else has been denied, or that we're giving Doug exclusive linking rights or
>>> something.  It just happens he has written the most comprehensive and
>>> maintained set of docs, and so it would be bureaucratically rather easy to
>>> get a bunch more helpful links in the docs that will help people learn
>>> Python better.  Frankly it doesn't matter if it's "blessed" as that doesn't
>>> incur any real benefit.
>>
>> Good call!
>>
> 
> +1000
> 
> Dougs docs are indispensable. The number of times I have had people at
> work and elsewhere come to me and ask "why aren't the PMOTW in, or
> linked to from the stdlib docs" is astounding. People consider them
> *better* resources than the stdlib docs right now. We shouldn't be
> afraid to link to real, valuable resources that enhance peoples'
> ability to learn the language and the standard library.

What Jesse said.

Georg





More information about the Python-ideas mailing list