Message369796
Hi @Chas Belov,
On Sun, May 24, 2020 at 1:27 AM Chas Belov <report@bugs.python.org> wrote:
> 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 readers.
>
> I am going to attempt a PR by May 26, 2020.
Are those sections really to be entered in the REPL or could they be
seen as independent code blocks in a file e.g.?
From the dev guide https://devguide.python.org/documenting/#code-examples
> The ellipsis for the sys.ps2 secondary interpreter prompt should only be used sparingly,
> where it is necessary to clearly differentiate between input lines and output lines.
> Besides contributing visual clutter, it makes it difficult for readers to cut-and-paste
> examples so they can experiment with variations.
None of those sections has output ... so maybe not put the ellipsis? |
|
Date |
User |
Action |
Args |
2020-05-24 12:17:41 | amaajemyfren | set | recipients:
+ amaajemyfren, Chas Belov |
2020-05-24 12:17:41 | amaajemyfren | link | issue40748 messages |
2020-05-24 12:17:41 | amaajemyfren | create | |
|