Message 198241 - Python tracker

Message198241

Author	ncoghlan
Recipients	eli.bendersky, ncoghlan, scoder, serhiy.storchaka
Date	2013-09-22.02:01:13
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<CADiSq7e6td0z07fTg10kZVY9Ow-vvtZyC4mPTM5QyM8UEq6nbA@mail.gmail.com>
In-reply-to	<CAF-Rda_zWj34wnbHMOGSq92hgUoSkP=z-suYf23t5OtQq9qkxQ@mail.gmail.com>

Content
An undocumented name without a leading underscore is always a bug, as it means introspection and the prose docs give conflicting definitions of the public API. Whether the fix is to remove the offending name entirely, add a leading underscore to mark it as private or document it as officially public is a judgement call that needs to be made on a case by case basis.

Content

An undocumented name without a leading underscore is always a bug, as it
means introspection and the prose docs give conflicting definitions of the
public API.

Whether the fix is to remove the offending name entirely, add a leading
underscore to mark it as private or document it as officially public is a
judgement call that needs to be made on a case by case basis.

History
Date	User	Action	Args
2013-09-22 02:01:13	ncoghlan	set	recipients: + ncoghlan, scoder, eli.bendersky, serhiy.storchaka
2013-09-22 02:01:13	ncoghlan	link	issue18990 messages
2013-09-22 02:01:13	ncoghlan	create