Closed fpagnoux closed 5 years ago
Strong agree. This should be provided for parameters as well, would it be only for uniformity.
Would you recommend this to be a new property like description
, or should we just use Python's heredoc ('''
) format? Heredoc are less common, but they allow for multiline, and are already used in Entities.
I agree with the need of multiline documentation for variables and parameters.
In Tunisia for example, we need some place to document evolutions on minimal wages parameters.
As for the best way to make this possible, @guillett @benjello would you recommend a property/ multiple properties/heredoc/...? I remember a studieuse meeting where we spoke about adding more information to legislation explorer pages.
We may start with a multiline entry (called Note for example) and progressively identify which properties we may add separately. We may use some format in the docstring so the it appears clearly to the dev and may be also used using doc formatting tools.
As a variable maintainer, I can document useful information about a variable. As a user of a tax and benefit information, I can know more precisely what is a variable, and how I can use it.
The legislation explorer extracts a lot of useful information from variables. However, we may want to keep and expose useful information that are not automatically extractible.
For instance:
loyer
is defined for a Menage but always used for a Famille. A line about how to easily cast it may help formula writers).