Ama Aje My Fren <amaajemyf...@gmail.com> added the comment:
Hi @Chas Belov, On Sun, May 24, 2020 at 1:27 AM Chas Belov <rep...@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? ---------- title: Tutorial 4 More Control Flow Tools missing screen prompts in some code blocks -> Tutorial 4.7 More on Defining Functions missing screen prompts _______________________________________ Python tracker <rep...@bugs.python.org> <https://bugs.python.org/issue40748> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
