From 9d9b3bc71702e4bd4b7f8e1602d83fd69f871e94 Mon Sep 17 00:00:00 2001
From: Natalia <124304+nessita@users.noreply.github.com>
Date: Fri, 1 Aug 2025 12:49:00 -0300
Subject: [PATCH] [5.1.x] Refs #36535 -- Doc'd that docutils < 0.22 is
 required.

---
 docs/internals/contributing/writing-code/unit-tests.txt | 2 +-
 docs/ref/contrib/admin/admindocs.txt                    | 2 +-
 tests/requirements/py3.txt                              | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/internals/contributing/writing-code/unit-tests.txt b/docs/internals/contributing/writing-code/unit-tests.txt
index 71aaa6dccb..5482abb411 100644
--- a/docs/internals/contributing/writing-code/unit-tests.txt
+++ b/docs/internals/contributing/writing-code/unit-tests.txt
@@ -316,7 +316,7 @@ dependencies:
 * :pypi:`asgiref` 3.8.1+ (required)
 * :pypi:`bcrypt`
 * :pypi:`colorama` 0.4.6+
-* :pypi:`docutils` 0.19+
+* :pypi:`docutils` 0.19 through 0.21.2
 * :pypi:`geoip2`
 * :pypi:`Jinja2` 2.11+
 * :pypi:`numpy`
diff --git a/docs/ref/contrib/admin/admindocs.txt b/docs/ref/contrib/admin/admindocs.txt
index edc29b4a5c..6eb58fb5ff 100644
--- a/docs/ref/contrib/admin/admindocs.txt
+++ b/docs/ref/contrib/admin/admindocs.txt
@@ -23,7 +23,7 @@ the following:
   your ``urlpatterns``. Make sure it's included *before* the
   ``'admin/'`` entry, so that requests to ``/admin/doc/`` don't get
   handled by the latter entry.
-* Install the :pypi:`docutils` 0.19+ package.
+* Install the :pypi:`docutils` package (versions 0.19 through 0.21.2 required).
 * **Optional:** Using the admindocs bookmarklets requires
   ``django.contrib.admindocs.middleware.XViewMiddleware`` to be installed.
 
diff --git a/tests/requirements/py3.txt b/tests/requirements/py3.txt
index 26d4b982fe..816c71af33 100644
--- a/tests/requirements/py3.txt
+++ b/tests/requirements/py3.txt
@@ -3,7 +3,7 @@ asgiref >= 3.8.1
 argon2-cffi >= 19.2.0
 bcrypt
 black == 24.10.0
-docutils >= 0.19
+docutils >= 0.19, < 0.22
 geoip2
 jinja2 >= 2.11.0
 numpy