[Python-ideas] Linking Doug's stdlib documentation to our main modules doc.
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>
>>>> 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!
> 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.
More information about the Python-ideas