classification
Title: docs: tutorial/introduction doesn't mention toggle of prompts
Type: enhancement Stage:
Components: Documentation Versions: Python 3.10, Python 3.9, Python 3.8
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: RJ722, davidmrdavid, docs@python, jfine2358, rhettinger
Priority: normal Keywords: easy

Created on 2018-08-21 18:50 by jfine2358, last changed 2021-01-06 05:20 by davidmrdavid.

Messages (4)
msg323839 - (view) Author: Jonathan Fine (jfine2358) * Date: 2018-08-21 18:50
Interactive code examples need the prompt to be stripped, before copy-and-paste. This is explained in https://docs.python.org/3/tutorial/introduction.html

But this page does not tell us about the [>>>] prompt-toggle at top of each interactive code example. This caused a user error, reported in  https://mail.python.org/pipermail/python-ideas/2018-August/052869.html.

The [>>>] toggle isn't in the Python 2.7 docs, so nothing to fix there!
msg381920 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2020-11-26 23:31
The toggle option is only in the HTML version with javascript enabled.  It would apply to PDF renderings or CHM files etc.
msg381928 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2020-11-27 02:25
- It would apply to PDF renderings or CHM files etc.
+ We wouldn't the the proposed text to be visible in PDF renderings or CHM files etc.
msg384472 - (view) Author: David Justo (davidmrdavid) Date: 2021-01-06 05:20
Hi folks! I'm interested in contributing to this issue, but I'm unsure about the context.

Can `>>>>` prompts be toggled on-and-off in the docs? I do not see that option. I read that this is possible in javascript-enabled versions of the site, but isn't that the default? If so, I have JS enabled and I do not see how to toggle them out :) . Maybe that's part of what we need to fix as well.

Thanks for your time!
History
Date User Action Args
2021-01-06 05:20:36davidmrdavidsetnosy: + davidmrdavid
messages: + msg384472
2021-01-02 00:11:01RJ722setnosy: + RJ722
2020-11-27 02:25:37rhettingersetmessages: + msg381928
2020-11-26 23:31:42rhettingersetnosy: + rhettinger
messages: + msg381920
2020-11-26 22:45:18iritkatrielsettype: enhancement
2020-11-26 22:45:07iritkatrielsetkeywords: + easy
versions: + Python 3.9, Python 3.10, - Python 3.4, Python 3.5, Python 3.6, Python 3.7
2018-08-21 18:50:18jfine2358create