> There is value in having non-trivial coverage of the language. When people > ask how > __cause__ works, we can link to the tutorial.
I don't necessarily agree with the rest, but I think this is very important - at least, in the current situation. Maybe in the future we will be able to rearrange and move some parts of the tutorial into the "how to" section, and/or to write more introductions to the various sections of the documentation... but for now, the tutorial is all we have. > Otherwise, we have to throw them to the > wolves by linking to the unfriendly, highly technical reference guide or to a > PEP. Indeed. The PEPs are the worst, more often than not. I remember when I first learned Pyhton, every time the documentation linked to a PEP, I felt a shiver down my spine. r. _______________________________________________ Python-Dev mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/[email protected]/message/LHGZNTRKU2Z2OD3W7DPFEDS274OBFE7F/ Code of Conduct: http://python.org/psf/codeofconduct/