[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