[docs] [issue37934] Docs: Clarify NotImplemented use cases

Raymond Hettinger report at bugs.python.org
Mon Aug 26 00:26:49 EDT 2019


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

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."

----------
nosy: +rhettinger
resolution:  -> rejected
stage: needs patch -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue37934>
_______________________________________


More information about the docs mailing list