[3.1.x] Fixed #23681, Fixed #27445 -- Doc'd setting choices for NullBooleanField widgets.

Thanks to David Smith for investigation and review.

Co-authored-by: Carlton Gibson <carlton.gibson@noumenal.es>
Backport of d976c254fc76e5f04d81dfd9d142c58e933c9c92 from master

1 files changed, 14 insertions, 0 deletions

diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt
index e43865ad4a..0bcf07ff08 100644
--- a/docs/ref/forms/fields.txt
+++ b/docs/ref/forms/fields.txt
@@ -913,6 +913,20 @@ For each field, we describe the default widget used if you don't specify
     * Normalizes to: A Python ``True``, ``False`` or ``None`` value.
     * Validates nothing (i.e., it never raises a ``ValidationError``).
 
+    ``NullBooleanField`` may be used with widgets such as
+    :class:`~django.forms.Select` or :class:`~django.forms.RadioSelect`
+    by providing the widget ``choices``::
+
+        NullBooleanField(
+            widget=Select(
+                choices=[
+                    ('', 'Unknown'),
+                    (True, 'Yes'),
+                    (False, 'No'),
+                ]
+            )
+        )
+
 ``RegexField``
 --------------