> I suspect that future documentation will have "How Tos" being more often
> written to cover more technical topics in detail. These more standalone
> "How Tos" can then be linked to from contents and search pages.

Indeed. Take for instance the most recent addition, regarding special 
parameters 
syntax. Now the entire section 4.7 has become long and complex, way beyond 
the limits of a beginner's tolerance. But a well-calibrated "functions 
parameters 
how to" could be an excellent remedy, even leading to the removal of this 
entire 
section from the tutorial. Now, this would be a deletion that I would welcome. 
I suspect there are quite a few (relatively) low hanging fruits like this one 
out there. 

best, 
riccardo
_______________________________________________
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/7S4W65OJQPIN66IY5NRNMQ6NZJ4T36R4/
Code of Conduct: http://python.org/psf/codeofconduct/

Reply via email to