Message 309293 - Python tracker

Message309293

Author	mpb
Recipients	Aaron Hall, docs@python, mpb, rhettinger
Date	2017-12-31.17:41:41
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1514742101.28.0.467229070634.issue30449@psf.upfronthosting.co.za>
In-reply-to

Content
@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!

Content

@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!

History
Date	User	Action	Args
2017-12-31 17:41:41	mpb	set	recipients: + mpb, rhettinger, docs@python, Aaron Hall
2017-12-31 17:41:41	mpb	set	messageid: <1514742101.28.0.467229070634.issue30449@psf.upfronthosting.co.za>
2017-12-31 17:41:41	mpb	link	issue30449 messages
2017-12-31 17:41:41	mpb	create