D401 "not in imperative mood" not truly applicable to @property #531
Comments
Same for DAR201, I don't think |
You should be able to use http://www.pydocstyle.org/en/stable/usage.html
|
The above suggested workaround ( What is the suggested/intended "mood" for a property docstring otherwise? I guess "Return the X property"? |
What is blocking a user from your perspective? How should this be more "surgical"?
How do you document the attributes/properties of classes otherwise? |
Fixed by #546 |
@property
methods are not used as methods. Their docstrings are used to set the description of the properties. Errors like D401 "docstring not in imperative mood" should not be applicable to methods, at least to getters, that define a@property
.IMHO, the following docstring should be accepted for
x
, although not in imperative mood:Alternatively, please classify these errors differently, so users can switch them off.
The text was updated successfully, but these errors were encountered: