Le 27/07/2012 11:18, DEGREMONT Aurelien a écrit :
Le 27/07/2012 09:43, nap a écrit :

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.
All automatic tool looking for python documentation expect to find them here.
pydoc, epydoc, pylint, ... will be happy with that.
And personnaly I use pydoc a lot when writing code.

I would even add that is a very good idea to stick to "Principle of least astonishment" (http://en.wikipedia.org/wiki/Principle_of_least_astonishment)
Python developers expects to find doc there, keep it there. If you do otherwise:
- they will be disturbed
- they have to learn an other way to get doc for Shinken source only.



Aurélien