[issue35221] Enhance venv activate commands readability

Change by Raymond Hettinger : -- resolution: -> fixed stage: patch review -> resolved status: open -> closed ___ Python tracker ___

[issue35221] Enhance venv activate commands readability

Raymond Hettinger added the comment: New changeset d170e594b2736c579d12b96b129a8e58975a9c0a by Raymond Hettinger (Miss Islington (bot)) in branch '3.7': bpo-35221: Additional hint that the placeholder is to be replaced. (GH-10604) (GH-10629)

[issue35221] Enhance venv activate commands readability

Raymond Hettinger added the comment: New changeset 7af2144e558a0268b1aa20bb88046716c89f987d by Raymond Hettinger (Miss Islington (bot)) in branch '3.6': bpo-35221: Additional hint that the placeholder is to be replaced. (GH-10604) (GH-10630)

[issue35221] Enhance venv activate commands readability

Change by miss-islington : -- pull_requests: +9877 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue35221] Enhance venv activate commands readability

Change by miss-islington : -- pull_requests: +9878 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue35221] Enhance venv activate commands readability

Raymond Hettinger added the comment: New changeset d936a8f8e0964de1147656f1435532f0170f8b6c by Raymond Hettinger (Julien Palard) in branch 'master': bpo-35221: Additional hint that the placeholder is to be replaced. (GH-10604)

[issue35221] Enhance venv activate commands readability

Julien Palard added the comment: Hi Raymond, I'm mentionning I've spotted the issue in my class just to say "it happen that newcomers don't get it, I've seen it". As I've seen it I want to fix it. I don't want to fix it only in my course (it does not scale) I want to fix it for everybody.

[issue35221] Enhance venv activate commands readability

Raymond Hettinger added the comment: I concur with Lisa that this is something the people need to learn (that is why they're taking a class). FWIW, I've seen people copy square brackets for optional arguments, "mypow(base[, exp])" and angle brackets for syntax, " if else ". We also see

[issue35221] Enhance venv activate commands readability

Change by Julien Palard : -- keywords: +patch pull_requests: +9847 stage: -> patch review ___ Python tracker ___ ___

[issue35221] Enhance venv activate commands readability

Change by Pablo Galindo Salgado : -- nosy: +pablogsal ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue35221] Enhance venv activate commands readability

Lisa Roach added the comment: Using plain angle brackets is common placeholder notation, and I think changing it to something different might be confusing to those who are familiar with the pattern. I have also seen plenty of people copying and pasting the wrong things because of this

[issue35221] Enhance venv activate commands readability

Steven D'Aprano added the comment: https://docs.python.org/3/library/venv.html > my students are often confused by it, sometimes they copy the angle brackets, > sometime even the prompt. Learning to recognise placeholders and the prompt is an essential part of learning to code, and a stage

[issue35221] Enhance venv activate commands readability

Julien Palard added the comment: Forgot to mention, the bold and italics one were done using unicode mathematical characters, they are not properly rendered in PDFs so we can't use them as is: https://mdk.fr/pdf.png -- ___ Python tracker

[issue35221] Enhance venv activate commands readability

New submission from Julien Palard : I'd like to enhance the readability of the "venv activation commands" in library/venv.html, my students are often confused by it, sometimes they copy the angle brackets, sometime even the prompt. I don't think we can fix everything, but maybe enhance a