Roundup Robot added the comment:
New changeset 2e3a81a0fa14 by Senthil Kumaran in branch '2.7':
Issue #16827: Make Interpreter introduction section of the tutorial more
https://hg.python.org/cpython/rev/2e3a81a0fa14
New changeset 1e81c7a261a7 by Senthil Kumaran in branch '3.4':
Issue #16827:
Senthil Kumaran added the comment:
I addressed Berker Peksag's review comments on Jame's patch, tested the local
building of docs, verified the content and looks.
Committed this in 2.7, 3.4 and 3.5.
Thank you all!
--
assignee: docs@python - orsenthil
resolution: - fixed
stage: patch
Changes by Berker Peksag berker.pek...@gmail.com:
--
stage: needs patch - patch review
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue16827
___
___
Changes by Berker Peksag berker.pek...@gmail.com:
--
nosy: +berker.peksag
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue16827
___
___
Berker Peksag added the comment:
Thanks for the patch, James. Did you see my review comments on Rietveld? Please
see at http://bugs.python.org/review/16827/#ps11699
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue16827
James Brewer added the comment:
It seems like this issue lost traction, so I decided to go ahead and apply
Eric's feedback. I've attached the relevant patch.
With that said, I agree with Senthil that sections 2.2.4 and 2.2.5 would be
better off between sections 13.1 and 13.2
--
nosy:
Senthil Kumaran added the comment:
For this bug, I think, section 2.2.4 and section 2.2.5 can be moved to section
13 and inserted between section 13.1 and 13.2 as it seem to be fit in naturally
there.
--
___
Python tracker rep...@bugs.python.org
Éric Araujo added the comment:
Thanks for the patch, I left a couple notes on the review site
(http://bugs.python.org/review/16827/).
Ezio suggested moving the doc about floating point issues to an appendix too;
what’s your opinion on that?
I wonder if the advanced contents should be placed
Éric Araujo added the comment:
By the way the section 13 is more about interactive Input editing,
which is different concept from interactive mode.
I think these are the same thing. Can you explain more?
--
___
Python tracker
Jamayla Wiley added the comment:
I moved the advanced content (all but 2.1, 2.2.3) from the 'Interpreter'
tutorial to the 'Interactive' appendix mentioned above.
--
keywords: +patch
nosy: +jdwiley
Added file: http://bugs.python.org/file34472/interpreter.patch
Ya-Ting Huang added the comment:
Hi I just uploaded my patch. I add one file appendix.rst, and move every part
except 2.1 and 2.2.3 to appendix. Also I add one line under the interactive
section to advice readers see more information in appendix. Please let me know
if I should reorganize
Ezio Melotti added the comment:
Those section could be moved to an appendix or somewhere near
http://docs.python.org/3/tutorial/interactive.html. Note that this page and
the one about float issues could be appendices too.
--
___
Python tracker
New submission from Ramchandra Apte:
Most of the content in section 2 in the tutorial,
http://docs.python.org/3/tutorial/interpreter.html , is relatively advanced and
doesn't belong in, at least, the beginning of the tutorial.
Only 2.1. Invoking the Interpreter, and 2.2.3. Source Code
Ezio Melotti added the comment:
+1
--
keywords: +easy
nosy: +chris.jerdonek, ezio.melotti
stage: - needs patch
type: - enhancement
versions: +Python 2.7, Python 3.2, Python 3.3, Python 3.4
___
Python tracker rep...@bugs.python.org
Senthil Kumaran added the comment:
+1 from me as well. I am also adding Eric who might have views on the
customization part which added by him.
--
nosy: +eric.araujo, orsenthil
___
Python tracker rep...@bugs.python.org
15 matches
Mail list logo