chango.git/docs/ref/forms, branch refs-37159

Fixed #37194 -- Removed redundant choice widget documentation.

2026-07-29T13:53:58Z

The removed section primarily provided usage examples and recommendations rather than documenting the widget API. The interaction between a choice field and its widget is already documented in the Select.choices reference.

Fixed minor typos and grammatical errors in docs and docstrings.

2026-07-24T13:36:57Z

Thanks to these people for pointing these out: * Hojeong Park * Natalia Bidart * Sulav Raj Bista

Fixed #37162 -- Updated ContactForm docs example to use safe practices.

2026-07-01T01:14:55Z

Updated the `ContactForm` examples in the "Forms" topic and reference docs to avoid broken and unsafe practices around sending email: * Stopped using user-provided `sender` address as `from_email`. Instead, renamed to `contact_email` and used it as the `reply_to` address. * Removed `cc_myself` option to prevent using the form to send spam. Substituted an `urgent` field to demonstrate `BooleanField` use. * Identified email as coming from the contact form and added other content to reduce impersonation/phishing risks. Also updated some example output in the forms reference docs where it had drifted from the example code over time: email fields default to `maxlength=320`; the `ContactForm` example has been using a `TextArea` widget for its message field.

Fixed #37116 -- Explained why a code is useful in a ValidationError.

2026-05-26T15:52:07Z

Fixed #16429 -- Extracted set_choices() method from FilePathField.init().

2026-04-29T18:52:25Z

Fixed #35870 -- Made blank choice label in forms more accessible.

2026-04-22T21:06:29Z

Added new constant django.db.models.fields.BLANK_CHOICE_LABEL for an accessible and translatable blank choice label in forms. Deprecated django.db.models.fields.BLANK_CHOICE_DASH constant. Added the immediately deprecated transitional setting USE_BLANK_CHOICE_DASH. Co-Authored-By: Marijke Luttekes

Fixed #33113 -- Documented usage and caveats of HTML5 date input in DateInput widget.

2026-04-13T07:00:59Z

Fixed #36904 -- Clarified how to hide form field labels in docs.

2026-03-19T16:39:17Z

Fixed a typo in docs/ref/forms/models.txt.

2026-01-09T00:10:40Z

Removed versionadded/changed annotations for 5.2.

2025-09-17T18:17:05Z