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 anthony-flury
Recipients anthony-flury, docs@python, lemburg, mark.dickinson, rhettinger, steven.daprano, stutzbach
Date 2021-04-09.16:54:43
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <[email protected]>
In-reply-to
Content
I fundamentally disagree with closing this - I know that this and many other 'quirks' catch beginners out, and the tutorial is what they use to learn.They don't look in the reference document - it is too dense in BNF definitions which turns a lot of people off from any other useful information - When I was researching this issue I didn't even think to look in the reference section.

Looking in the library section for information about the built-in types is also non-obvious to beginners. 

If the tutorial doesn't contain the detail, and doesn't link to the detail then beginners are left entirely puzzled by the behavior.

Given how difficult it is to search the documentation if you don't know exactly what you are looking for, then how beginners would know to look at the FAQ is beyond me. Having communicated with a number of beginners on a number of issues they had no idea that the FAQ even existed.

The change didn't 'bury the tutorial in detail' - it added once sentence which linked to the FAQ. In fact all the change did was expand the FAQ entry by a few lines and link to the FAQ from the three places that are relevant.

I think this is a small change and it should be the start of making the tutorial beginner friendly.
History
Date User Action Args
2021-04-09 16:54:43anthony-flurysetrecipients: + anthony-flury, lemburg, rhettinger, mark.dickinson, stutzbach, steven.daprano, docs@python
2021-04-09 16:54:43anthony-flurysetmessageid: <[email protected]>
2021-04-09 16:54:43anthony-flurylinkissue43737 messages
2021-04-09 16:54:43anthony-flurycreate