[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