← Back to team overview

c2c-oerpscenario team mailing list archive

[Bug 525685] Re: Use __doc__ as a default for _description

 

the docstring is quite different from the description.
The description is a one-line english name of the object, for readability.
The docstring can be a technical description of the object.
I propose to keep them separated to avoid confusion.

** Changed in: openobject-server/trunk
       Status: New => Invalid

-- 
Use __doc__ as a default for _description
https://bugs.launchpad.net/bugs/525685
You received this bug notification because you are a member of C2C
OERPScenario, which is subscribed to the OpenERP Project Group.

Status in OpenObject Server: Invalid
Status in OpenObject Server trunk series: Invalid

Bug description:
As it turns out, when developers define a dosctring in an object definition, they often use the same as _description. It seems Tryton has even made is a standard to set _description = __doc__, which probably makes sense.
I think it will help is _description defaults to the first line of __doc__.
Lionel