This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author Chas Belov
Recipients Chas Belov, amaajemyfren, docs@python
Date 2020-05-24.20:34:16
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1590352457.14.0.0722275473169.issue40748@roundup.psfhosted.org>
In-reply-to
Content
@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 documentation, I would argue that the Tutorial is not a place for shorthand. Learning a new language is hard enough without having to also struggle with inconsistencies in the tutorial interface.

My intent with this issue and my (upcoming) pull request is to make the mentioned code blocks consistent with the rest of the page and, indeed, with most of the rest of the tutorial. Most of the tutorial does show >>> and ... at the beginning of each line where the learner would see a prompt. If we are to avoid ... so that learners can copy and paste multiple lines, then why would we not do that through the entire tutorial?

I'm guessing your point is that we only need to show >>> and ... when there will be print output so that we need to distinguish between what is input and what is output. As someone who is currently learning Python, however, consistency in presentation is important to me and reduces cognitive load.

There are other places in the tutorial where code blocks were used for things which are not typed in, or are not typed without other text. Showing >>> and ... for all verbatim input makes it unambiguous as to whether something is to be typed in.

I'll leave it to psychologists as to whether having to type or copy and paste one line at a time leads to better learning. 

By REPL, do you mean Read-Eval-Print Loop? I'm not familiar with the acronym and that's what Google is telling me it means. But a Read-Eval-Print Loop would have output, and my understanding is that you are arguing against use of ... when there is no output.
History
Date User Action Args
2020-05-24 20:34:17Chas Belovsetrecipients: + Chas Belov, docs@python, amaajemyfren
2020-05-24 20:34:17Chas Belovsetmessageid: <1590352457.14.0.0722275473169.issue40748@roundup.psfhosted.org>
2020-05-24 20:34:17Chas Belovlinkissue40748 messages
2020-05-24 20:34:16Chas Belovcreate