Proposal to extend PEP 257 (New Documentation String Spec)

George Rodrigues da Cunha Silva georger.silva at
Fri Jul 15 17:44:14 CEST 2011

Em sexta-feira, 15 de julho de 2011 04:13:43, Chris Angelico escreveu:
> 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.
> ChrisA

I'm with Chris. If you mandate this sort of things on the programmer 
this will just go downhill.


George Rodrigues da Cunha Silva
Desenvolvedor GIS

More information about the Python-list mailing list