Inada Naoki <songofaca...@gmail.com> added the comment: >> 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-...@python.org/thread/MXMEFFYB6JXAKSS36SZ7DX4ASP6APWFP/ * another thread: https://mail.python.org/archives/list/python-...@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-...@python.org/message/IWW2YBLJK4T3OWSKDUDVDVXPWDGIFWTC/ ). ---------- _______________________________________ Python tracker <rep...@bugs.python.org> <https://bugs.python.org/issue42179> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
