This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author gvanrossum
Recipients Eric Lafontaine, docs@python, gvanrossum, rhettinger, tebeka
Date 2016-12-17.16:26:25
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1481991985.84.0.715419674588.issue28972@psf.upfronthosting.co.za>
In-reply-to
Content
I'm neutral on this idea.  I would much rather focus on making sure that the various modules (such as pdb or tarfile) which have useful command-line functionality document that clearly and uniformly, but as part of each module's library docs.

I don't think that a list of all modules that have such behavior really belongs in the stdlib docs, but if someone wants to add it and keep it up to date I won't object.  Just understand that whatever is documented must preserve some sort of backwards compatibility.  And don't repeat the same information in two places.

Maybe the blog post that started this is actually enough?  Or if something more official is needed, perhaps a how-to document?
History
Date User Action Args
2016-12-17 16:26:25gvanrossumsetrecipients: + gvanrossum, rhettinger, tebeka, docs@python, Eric Lafontaine
2016-12-17 16:26:25gvanrossumsetmessageid: <1481991985.84.0.715419674588.issue28972@psf.upfronthosting.co.za>
2016-12-17 16:26:25gvanrossumlinkissue28972 messages
2016-12-17 16:26:25gvanrossumcreate