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 rhettinger
Recipients aeros, docs@python, eric.araujo, ezio.melotti, jdemeyer, mdk, rhettinger, veky, willingc
Date 2019-08-26.04:26:49
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1566793609.56.0.783170218578.issue37934@roundup.psfhosted.org>
In-reply-to
Content
It is not the purpose of the docs to list use cases.  Mostly we say what something does or how it is defined.  As Vedran says, how people use it is their own business.

Also, please be careful expanded the docs.  They quickly become a promise.  Per Doc/reference/introduction.rst, "It is dangerous to add too many implementation details to a language reference document --- the implementation may change, and other implementations of the
same language may work differently."
History
Date User Action Args
2019-08-26 04:26:49rhettingersetrecipients: + rhettinger, ezio.melotti, eric.araujo, docs@python, jdemeyer, willingc, veky, mdk, aeros
2019-08-26 04:26:49rhettingersetmessageid: <1566793609.56.0.783170218578.issue37934@roundup.psfhosted.org>
2019-08-26 04:26:49rhettingerlinkissue37934 messages
2019-08-26 04:26:49rhettingercreate