Right now when documenting a field with choices, the values of those choices are all that is included. This is frustrating because usually the display name of the choice documents what it means.
Proposed Solution
Add display names to choices documentation, i.e. change
f"* ``{key}``" if key != "" else "* ``''`` (Empty string)"
for key, value in field.choices[:choices_limit]
to
f"* ``{key}: {value}``" if key != "" else "* ``''`` (Empty string)"
for key, value in field.choices[:choices_limit]
in attributes.get_field_details (or something along those lines).
Motivation
Right now when documenting a field with choices, the values of those choices are all that is included. This is frustrating because usually the display name of the choice documents what it means.
Proposed Solution
Add display names to choices documentation, i.e. change
to
in
attributes.get_field_details
(or something along those lines).