[1.10.x] Fixed #27387 -- Doc'd required HTML attribute in Field.required docs.

Backport of 611ef422b173b450b1fc6f7f94eb262961b24e54 from master

1 files changed, 9 insertions, 0 deletions

diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt
index 49e326b300..8aaee62a28 100644
--- a/docs/ref/forms/fields.txt
+++ b/docs/ref/forms/fields.txt
@@ -92,6 +92,15 @@ then ``clean()`` will return a *normalized* empty value rather than raising
 For other ``Field`` classes, it might be ``None``. (This varies from field to
 field.)
 
+Widgets of required form fields have the ``required`` HTML attribute. Set the
+:attr:`Form.use_required_attribute` attribute to ``False`` to disable it. The
+``required`` attribute isn't included on forms of formsets because the browser
+validation may not be correct when adding and deleting formsets.
+
+.. versionadded:: 1.10
+
+    Support for the ``required`` HTML attribute was added.
+
 ``label``
 ---------