From 8654903fef17914a712d5468b7dbc9ec97c52c70 Mon Sep 17 00:00:00 2001
From: Mariana <mmariana.pereira.20@gmail.com>
Date: Thu, 31 Oct 2024 11:38:10 +0000
Subject: [PATCH] Updated documentation

---
 docs/ref/forms/widgets.txt | 40 ++++++++++++++++++++++++++------------
 docs/releases/5.2.txt      |  3 +++
 2 files changed, 31 insertions(+), 12 deletions(-)

diff --git a/docs/ref/forms/widgets.txt b/docs/ref/forms/widgets.txt
index 333c422ae8..306a67ffe7 100644
--- a/docs/ref/forms/widgets.txt
+++ b/docs/ref/forms/widgets.txt
@@ -111,6 +111,20 @@ with fields which are not based on choice -- such as a :class:`CharField` --
 but it is recommended to use a :class:`ChoiceField`-based field when the
 choices are inherent to the model and not just the representational widget.
 
+.. versionchanged:: 5.2
+
+For widgets that have options on their own, like those inheriting from ``ChoiceWidget``,
+you can also pass option-specific attributes using ``option_attrs``.
+For example, if you wish to set custom CSS classes for a RadioSelect's options, you could
+do as follows:
+
+.. code-block:: pycon
+
+    >>> from django.forms.widgets import RadioSelect
+    >>> widget = RadioSelect(choices=(("J", "John"),), option_attrs={"class": "special"})
+    >>> widget.render(name="beatle", value=["J"])
+    '<div><div>\n    <label><input type="radio" name="beatle" value="J" class="special" checked>\n John</label>\n\n</div>\n</div>'
+
 Customizing widget instances
 ============================
 
@@ -195,18 +209,6 @@ Django will then include the extra attributes in the rendered output:
 You can also set the HTML ``id`` using :attr:`~Widget.attrs`. See
 :attr:`BoundField.id_for_label` for an example.
 
-For widgets that have options on their own, like those inheriting from ``ChoiceWidget``,
-you can also pass option-specific attributes using ``option_attrs``.
-For example, if you wish to set custom CSS classes for a RadioSelect's options, you could
-do as follows:
-
-.. code-block:: pycon
-
-    >>> from django.forms.widgets import RadioSelect
-    >>> widget = RadioSelect(choices=(("J", "John"),), option_attrs={"class": "special"})
-    >>> widget.render(name="beatle", value=["J"])
-    '<div><div>\n    <label><input type="radio" name="beatle" value="J" class="special" checked>\n John</label>\n\n</div>\n</div>'
-
 .. _styling-widget-classes:
 
 Styling widget classes
@@ -756,6 +758,20 @@ that specifies the template used to render each choice. For example, for the
         This attribute is optional when the form field does not have a
         ``choices`` attribute. If it does, it will override anything you set
         here when the attribute is updated on the :class:`Field`.
+    
+    .. attribute:: Select.option_attrs
+
+        .. versionadded:: 5.2
+
+        An optional dictionary containing option-specific HTML attributes to
+        be set on the rendered widget.
+
+        .. code-block:: pycon
+
+            >>> from django.forms.widgets import RadioSelect
+            >>> widget = RadioSelect(choices=(("J", "John"),), option_attrs={"class": "special"})
+            >>> widget.render(name="beatle", value=["J"])
+            '<div><div>\n    <label><input type="radio" name="beatle" value="J" class="special" checked>\n John</label>\n\n</div>\n</div>'
 
 ``NullBooleanSelect``
 ~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/releases/5.2.txt b/docs/releases/5.2.txt
index 96007887bc..0be723a760 100644
--- a/docs/releases/5.2.txt
+++ b/docs/releases/5.2.txt
@@ -223,6 +223,9 @@ Forms
 * The new :class:`~django.forms.TelInput` form widget is for entering telephone
   numbers and renders as ``<input type="tel" ...>``.
 
+* The new :attr:`~django.forms.Select.option_attrs` attribute can be used to
+  specify option-specific HTML attributes.
+
 Generic Views
 ~~~~~~~~~~~~~