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 methane
Recipients Vladimir Ryabtsev, docs@python, eric.araujo, maxking, methane, miss-islington, rhettinger, willingc
Date 2020-11-09.01:45:35
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1604886335.61.0.953858618341.issue42179@roundup.psfhosted.org>
In-reply-to
Content
>> 1. Such understanding of a tutorial is debatable. Tutorial is just a material for learning written with some system in mind, which is more interesting to read than dry reference material. A tutorial, generally dpeaking, may be both for beginners and for professionals.
>
> OK, I will send this topic to python-dev first.

For the record, there is a long thread in python-dev about this issue:

* main thread: https://mail.python.org/archives/list/python-dev@python.org/thread/MXMEFFYB6JXAKSS36SZ7DX4ASP6APWFP/
* another thread: https://mail.python.org/archives/list/python-dev@python.org/thread/WNHVZLEO3ZVDOFP2FHRBUQR4GY24RIJJ/

## High level discussion: focus on new user vs write more and more details.

More detail:
* Abdur-Rahmaan Janhangeer

Focus on new user:
* Paul Moore 
* Brett Cannon
* Guido van Rossum
* Kyle Stanley
* Carol Willing
* Serhiy Storchaka

## About this specific case. (Adding __context__ and __suppress_context vs removing __cause__)

Add __context__:
(no one)

Remove __cause__:
* Kyle Stanley
* Éric Araujo (in GH-23160)

Riccardo Polignieri asked that to be very careful about removing something, but he did not vote for adding __context__ and __supress_context__.

--

I merged PR-23162 for keep focus on new users and consistent for now.

But I have not closed this issue yet because documentation WG may revisit the issue. (see https://mail.python.org/archives/list/python-dev@python.org/message/IWW2YBLJK4T3OWSKDUDVDVXPWDGIFWTC/ ).
History
Date User Action Args
2020-11-09 01:45:35methanesetrecipients: + methane, rhettinger, eric.araujo, docs@python, maxking, willingc, miss-islington, Vladimir Ryabtsev
2020-11-09 01:45:35methanesetmessageid: <1604886335.61.0.953858618341.issue42179@roundup.psfhosted.org>
2020-11-09 01:45:35methanelinkissue42179 messages
2020-11-09 01:45:35methanecreate