[issue40748] Tutorial 4.7 More on Defining Functions missing screen prompts

2020-05-24 Thread Chas Belov
Chas Belov added the comment: I created new issue For 7.2.7. Code Examples, distinguish between the Tutorial and other documentation https://bugs.python.org/issue40758 -- ___ Python tracker <https://bugs.python.org/issue40

[issue40758] For 7.2.7. Code Examples, distinguish between the Tutorial and other documentation

2020-05-24 Thread Chas Belov
New submission from Chas Belov : 7.2.7. Code Examples https://devguide.python.org/documenting/#code-examples states: Short code examples can be a useful adjunct to understanding. Readers can often grasp a simple example more quickly than they can digest a formal description in prose. [snip

[issue40758] For 7.2.7. Code Examples, distinguish between the Tutorial and other documentation

2020-05-24 Thread Chas Belov
Change by Chas Belov : -- versions: +Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 3.9 ___ Python tracker <https://bugs.python.org/issue40758> ___ ___

[issue40748] Tutorial 4.7 More on Defining Functions missing screen prompts

2020-05-24 Thread Chas Belov
Chas Belov added the comment: Actually, after reviewing the documentation standards, I will hold off my pull request on this issue and raise the cited section of documentation as a separate issue. -- ___ Python tracker <https://bugs.python.

[issue40748] Tutorial 4.7 More on Defining Functions missing screen prompts

2020-05-24 Thread Chas Belov
Chas Belov added the comment: @Ama Aje My Fren, thank you for the advice re backporting. As to your points on ..., both good points, and thank you for introducing me to the Documenting Python document, which I will review. While technically the Tutorial is indeed part of Python's

[issue40748] Tutorial 4 More Control Flow Tools missing screen prompts in some code blocks

2020-05-23 Thread Chas Belov
Chas Belov added the comment: Also in For statements https://docs.python.org/3.10/tutorial/controlflow.html#for-statements (same issue) However, a few of the code blocks having this issue don't exist in the documentation of earlier versions. Do I need a separate issue for each code block

[issue40748] Tutorial 4 More Control Flow Tools missing screen prompts in some code blocks

2020-05-23 Thread Chas Belov
Chas Belov added the comment: Also in For statements https://docs.python.org/3.10/tutorial/controlflow.html#for-statements (same issue) -- title: Tutorial 4.7 More on Defining Functions missing screen prompts -> Tutorial 4 More Control Flow Tools missing screen prompts in some c

[issue40748] Tutorial 4.7 More on Defining Functions missing screen prompts

2020-05-23 Thread Chas Belov
New submission from Chas Belov : The tutorial on More on Defining Functions at https://docs.python.org/3.7/tutorial/controlflow.html#more-on-defining-functions is missing most of the >>> and ... screen prompts that show elsewhere in the tutorial. This is potentially confusing to re

[issue40640] Tutorial for Continue missing ... line

2020-05-23 Thread Chas Belov
Chas Belov added the comment: @Florian Dahlitz, thank you for your help. I have created a PR at https://github.com/python/cpython/pull/20334 and it is awaiting approval of my CLA and of the change itself. -- ___ Python tracker <ht

[issue40640] Tutorial for Continue missing ... line

2020-05-23 Thread Chas Belov
Change by Chas Belov : -- keywords: +patch pull_requests: +19602 stage: -> patch review pull_request: https://github.com/python/cpython/pull/20334 ___ Python tracker <https://bugs.python.org/issu

[issue40640] Tutorial for Continue missing ... line

2020-05-23 Thread Chas Belov
Chas Belov added the comment: @DahlitzFlorian: I'm happy do to the PR provided I don't actually have to build Python to work on a documentation change. If it does require building Python then please go ahead. That said, I've looked at the Doc/tutorial/controlflow.rst and it appears

[issue40640] Tutorial for Continue missing ... line

2020-05-22 Thread Chas Belov
Chas Belov added the comment: Um, Python newcomer here. What's a PR? Pull request? I'm happy to do it if you can point me to the how-to. I know my way around git, and not around Python community standards. You are also welcome to go ahead and make the change; thank you for asking

[issue40641] Reserved word pair used in lambda tutorial without being noted as a reserved word

2020-05-16 Thread Chas Belov
New submission from Chas Belov : In the tutorial for lambda expressions at https://docs.python.org/3.7/tutorial/controlflow.html#lambda-expressions the reserved word pair is introduced without noting that it is a reserved word. In the example given, I wasn't sure whether pair was a reserved

[issue40640] Tutorial for Continue missing ... line

2020-05-16 Thread Chas Belov
New submission from Chas Belov : The tutorial code for Continue at https://docs.python.org/3.7/tutorial/controlflow.html#break-and-continue-statements-and-else-clauses-on-loops is missing a ... null statement. Actual code/result: >>> for num in range(2, 10): ... if num

[issue40620] Range tutorial shorthand could be made clearer

2020-05-14 Thread Chas Belov
New submission from Chas Belov : I found https://docs.python.org/3.7/tutorial/controlflow.html#the-range-function section 4.3 confusing. The range() Function shows the following example: >>> for i in range(5): ... print(i) ... 0 1 2 3 4 [some instructional text] range(5, 10)

[issue1076955] Tutorial corrections (various issues spaced throughout the document)

2020-05-13 Thread Chas Belov
Change by Chas Belov : -- title: Tutorial corrections -> Tutorial corrections (various issues spaced throughout the document) ___ Python tracker <https://bugs.python.org/issue1

[issue11425] Cleanup sample code spacing and block arrangement in tutorial.

2020-05-13 Thread Chas Belov
Change by Chas Belov : -- title: Cleanup sample codes in tutorial. -> Cleanup sample code spacing and block arrangement in tutorial. ___ Python tracker <https://bugs.python.org/issu

[issue3490] Example Code Error in Tutorial Documentation Section 4.4

2020-05-13 Thread Chas Belov
Change by Chas Belov : -- title: Example Code Error in Tutorial Documentation -> Example Code Error in Tutorial Documentation Section 4.4 ___ Python tracker <https://bugs.python.org/iss