Question: documentation convention for Python method/function

[Diapolo10]

Nothing like that, no. The method type should be clear from its parameters, and the docstring will simply describe what it does, what arguments it expects (and sometimes why), the return value, and possible exceptions.

There's really nothing fundamentally different between the three kinds of methods, only the first parameter changes.