I don't think I'm the one who can say if PEP257 is good for invenio or not.

I do agree with this though as repeating the module name violates the DRY principle.
> * The docstring is a phrase ending in a period. It prescribes the function or method's effect as a command ("Do this", "Return that"), not as a description; e.g. don't write "Returns the pathname ...".
> * The one-line docstring should NOT be a "signature" reiterating the function/method parameters (which can be obtained by introspection).
> 
> http://legacy.python.org/dev/peps/pep-0257/