Proposal to extend PEP 257 (New Documentation String Spec)

Chris Angelico rosuav at gmail.com
Fri Jul 15 09:13:43 CEST 2011


On Fri, Jul 15, 2011 at 9:02 AM, rantingrick <rantingrick at gmail.com> wrote:
> Too many folks
> are refusing to document properly and so i will take this time to
> hammer out a spec.

The tighter you squeeze your fist, Lord Rick, the more star
programmers will slip through your fingers.

Make it so docstrings HAVE to be in a particular format, and people
will stop writing docstrings. Make it so Python functions HAVE to have
docstrings, and people will stop writing Python functions.

ChrisA



More information about the Python-list mailing list