Proposal to extend PEP 257 (New Documentation String Spec)

[Chris Angelico]

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