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

Tarek Ziadé ziade.tarek at gmail.com
Fri Mar 18 06:50:51 CET 2011


I don't know about any other place where there's such an exhaustive
documentation of the stdlib.

Every module we have, have  more examples in Doug's work than in the stdlib
doc itself or elsewhere.

I think this doc is the best one we have and not pointing to it is too bad
ihmo.
 Le 17 mars 2011 18:48, "Steven D'Aprano" <steve at pearwood.info> a
écrit :
> Terry Reedy wrote:
>> On 3/17/2011 7:19 PM, Senthil Kumaran wrote:
>>> On Wed, Mar 16, 2011 at 05:35:41PM -0400, Doug Hellmann wrote:
>>>
>>>>> As I told Doug during Pycon, I think it would be a good idea to
>>>>> link his PyMOTW pages to our modules documentation in
>>>>> docs.python.org so people have more examples etc.
>>
>> Various people have written various docs showing Python by example. I do
>> not think any one should be singled out in the docs. On the other hand,
>> the wiki could have a PythonByExample page (or pages) with links to
>> various resources.
>
> What he said.
>
> 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?
>
> I wouldn't mind having a prominent "External resources" page in the
> Python docs, if it is actively maintained and doesn't turn into a bunch
> of dead links in 12 months time. But I have grave doubts about linking
> to an external site all through the module documentation, no matter how
> useful it is. Who controls the external content?
>
>
> --
> Steven
>
> _______________________________________________
> Python-ideas mailing list
> Python-ideas at python.org
> http://mail.python.org/mailman/listinfo/python-ideas
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-ideas/attachments/20110317/af1c8725/attachment.html>


More information about the Python-ideas mailing list