Proposal to extend PEP 257 (New Documentation String Spec)

George Rodrigues da Cunha Silva georger.silva at gmail.com
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 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

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

George

-- 
--------------------------------
George Rodrigues da Cunha Silva
Desenvolvedor GIS
http://geoprocessamento.net
http://blog.geoprocessamento.net



More information about the Python-list mailing list