Unclear documentation in newforms
|Reported by:||Owned by:||nobody|
|Has patch:||yes||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
Just above this link is some unnecessarily wordy text:
"Each text label is surrounded in an HTML <label> tag, which points to
the appropriate form field via its id. Its id, in turn, is generated
by prepending 'id_' to the field name."
This is unnecessarily wordy and confusing to at least myself and another developer I've asked.
A clearer description would be:
"Each text label is surrounded in an HTML <label> tag, whose 'for'
attribute contains the id of the appropriate form field."