[Python-Dev] PEP 257 and __init__

2015年12月29日 10:52:13 -0800

Hola!
(I was doubting in sending this mail to this list or to the normal
one, but as it affects a "style recommendation" we propose for the
whole community, I finally sent it here)
I was reading PEP 257 and it says that all public methods from a class
(including __init__) should have a docstring.
Why __init__?
It's behaviour is well defined (inits the instance), and the
initialization parameters should be described in the class' docstring
itself, right?
Or I am missing something?
Should we remove "__init__" (the class method, *not* the package file)
as to require docstrings in the PEP?
Thanks!
-- 
. Facundo
Blog: http://www.taniquetil.com.ar/plog/
PyAr: http://www.python.org/ar/
Twitter: @facundobatista
_______________________________________________
Python-Dev mailing list
[email protected]
https://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
https://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com

Reply via email to