[docs] [issue30449] Improve __slots__ datamodel documentation
mpb
report at bugs.python.org
Sun Dec 31 12:41:41 EST 2017
mpb <mpb.mail at gmail.com> added the comment:
@rhettinger
I disagree (but you're the boss). If a function can take type X as a parameter, I believe docs should also say what the expected behavior is when you call the function and pass it type X, especially when type X is fundamentally different from every other type the function accepts. (And yes, __slots__ is not a function, but I still find the metaphor apt.)
Cheers!
----------
_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue30449>
_______________________________________
More information about the docs
mailing list