Proposal to extend PEP 257 (New Documentation String Spec)

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

On Fri, Jul 15, 2011 at 9:02 AM, rantingrick <rantingrick at> 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.


More information about the Python-list mailing list