Rendering "required" as HTML attribute is not documented under Field.required

[karyon]

​https://docs.djangoproject.com/en/1.10/releases/1.10/#forms says

Required form fields now have the required HTML attribute. Set the new 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.

i would expect all of that (it's rendered, can be disabled, isn't rendered in formsets) to appear somewhere around ​https://docs.djangoproject.com/el/1.10/ref/forms/fields/#required, but it does not.

ref https://code.djangoproject.com/ticket/27299. I guess this per-widget option should rather not be mentioned in the field documentation...?

[Tim Graham]

See ec6121693f112ae33b653b4364e812722d2eb567 for the change and all places the documentation was updated. I guess it's a matter of judgment how many times to repeat certain things and to add links as appropriate.

[Zbigniew Siciarz]

It makes sense to me to add a versionadded note and refer to 1.10 release notes for details. I've created a PR here: ​https://github.com/django/django/pull/7485

[Claude Paroz]

New ​PR.

[Tim Graham <timograham@…>]

In 611ef42:

Fixed #27387 -- Doc'd required HTML attribute in Field.required docs.

[Tim Graham <timograham@…>]

In f3af0acb:

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

Backport of 611ef422b173b450b1fc6f7f94eb262961b24e54 from master