Opened 17 years ago

Closed 17 years ago

#4769 closed (fixed)

Unclear documentation in newforms

Reported by: crankycoder@… Owned by: nobody
Component: Documentation Version: dev
Severity: Keywords: newforms
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

Just above this link is some unnecessarily wordy text:

http://www.djangoproject.com/documentation/newforms/#as-p

"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."

Change History (2)

comment:1 by anonymous, 17 years ago

Triage Stage: UnreviewedAccepted

comment:2 by James Bennett, 17 years ago

Resolution: fixed
Status: newclosed

The relevant section of the newforms documentation appears to have been edited since this ticket was opened, and no longer seems to be confusing. If you still have problems following it, please re-open this ticket with specific suggestions for the current documentation.

Note: See TracTickets for help on using tickets.
Back to Top