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

Steven D'Aprano steve at pearwood.info
Fri Mar 18 02:47:50 CET 2011

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?


More information about the Python-ideas mailing list