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
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
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>
___
___
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.
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
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
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
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
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
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
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 a
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
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 res
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
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)
Change by Chas Belov :
--
title: Tutorial corrections -> Tutorial corrections (various issues spaced
throughout the document)
___
Python tracker
<https://bugs.python.org/issue1
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
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
18 matches
Mail list logo