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

Terry Reedy tjreedy at udel.edu
Sun Mar 20 09:16:31 CET 2011


On 3/19/2011 5:39 PM, Nick Coghlan wrote:
> On Sun, Mar 20, 2011 at 3:27 AM, Jesse Noller
>> Why is it so hard to simply do the right thing here?

First one must decide what is the right thing.

Do you agree that adding 2.x examples to 3.x doc is the wrong thing?

The initial proposal did not mention the Python version that Doug's work 
applies to, and indeed
http://www.doughellmann.com/PyMOTW/about.html
(still) does not either. Ths only hint on that page is the example 
showing that 'import PyMOTW' works on 2.6. I had to go to Amazon to 
discover and report that the book is aimed at (and presumably tested 
with) 2.7.

The initial proposal also did not specify the version of the docs to be 
augmented. Usually, these days, 'add x to the docs' means to add to the 
current 3.x development docs and maybe backport. I do not see '2.7' in 
the subject line above. I believe I was the first to raise these issues.

> Because it's a new idea and a level of
> integration-without-incorporation that hasn't been considered before.
> The PSF reps on here (along with everyone else) wouldn't be doing a
> good job as stewards of the language if valid concerns were glossed
> over without being given due consideration.

+1

-- 
Terry Jan Reedy




More information about the Python-ideas mailing list