Le 27/07/2012 11:18, DEGREMONT Aurelien a écrit :
Le 27/07/2012 09:43, nap a écrit :
I would even add that is a very good idea to stick to "Principle of least astonishment"
All automatic tool looking for python documentation expect to find
And I don't plan to add them unless someone explain me why it's
a good idea to put a explanation about a function between the
prototype and the code.
pydoc, epydoc, pylint, ... will be happy with that.
And personnaly I use pydoc a lot when writing code.
Python developers expects to find doc there, keep it there. If you
- they will be disturbed
- they have to learn an other way to get doc for Shinken source