Inada, as I said before, mine was more a general consideration than a criticism of a particular change (let alone a particular committer!).
> But the tutorial isn't a "special attribute showcase". > It doesn't cover all special attributes and describe how Python > interpreter use the special attributes under the ground. > So removing __cause__ made the tutorial more consistent right now. Eh... as you know very well, at some point the tutorial lists *all* the methods of a list... and at another point, when presenting "sys" in the standard library tour, the really important thing it feels the need to say is that we have "sys.ps1" and "sys.ps2" to customize the prompt... and at another point, while dealing with the very simple task of telling us what is a docstring, it is keen to explain also how a docstring parser tool should work... So, let's just say that there are quite a few quirks in the tutorial, and establishing what is "consistent" is anyone's guess, ok? > I said I considered removing "explicit" chaining (e.g. from exc). > But I said "implicit chaining is enough for 99% use cases". > Definitely, I never tried to "remove an entire important concept from > the tutorial." Look, we are really trading in hypotheticals here, because no one has actually deleted anything important at the end of the day... But for the sake of the argument, I venture that it might be slightly more complicated than expected to draw a line and say what is enough for 99% use cases, in a language as widely used as Python. This is not to say that I wouldn't gloss over exception chaining myself... if I were writing a tutorial for beginners. And I would certainly advocate for such a document to be added to the Python documentation, at some point in the future. My point, however, is that the document we have right now is *not* this tutorial, and yet it can still be of use to many people (who may or may not be "beginners"), just as it is now. And, that if you start removing things, on the one hand you are not doing beginners a favor big enough, while you might be damaging (even if only scratching) something useful for others. best, r. _______________________________________________ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/BDB4KXCSW2QKSISI7JN2XTKI73UKVBJF/ Code of Conduct: http://python.org/psf/codeofconduct/
