From 7335a1a9138e905aa681169c3b820fed207edfa5 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] [4.2.x] Refs #36535 -- Doc'd that docutils < 0.22 is
 required.

Backport of 9d9b3bc71702e4bd4b7f8e1602d83fd69f871e94 from stable/5.1.x.
---
 docs/internals/contributing/writing-code/unit-tests.txt | 2 +-
 docs/ref/contrib/admin/admindocs.txt                    | 3 ++-
 tests/requirements/py3.txt                              | 2 +-
 3 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/internals/contributing/writing-code/unit-tests.txt b/docs/internals/contributing/writing-code/unit-tests.txt
index 874038a55f..7d5a98812e 100644
--- a/docs/internals/contributing/writing-code/unit-tests.txt
+++ b/docs/internals/contributing/writing-code/unit-tests.txt
@@ -284,7 +284,7 @@ dependencies:
 * :pypi:`asgiref` 3.6.0+ (required)
 * :pypi:`bcrypt`
 * :pypi:`colorama`
-* :pypi:`docutils`
+* :pypi:`docutils` <0.22
 * :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 cc121a7bed..9806aa2439 100644
--- a/docs/ref/contrib/admin/admindocs.txt
+++ b/docs/ref/contrib/admin/admindocs.txt
@@ -23,7 +23,8 @@ 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 docutils Python module (https://docutils.sourceforge.io/).
+* Install the docutils Python module version <0.22
+  (https://docutils.sourceforge.io/).
 * **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 7eebc20e05..b166df7bb4 100644
--- a/tests/requirements/py3.txt
+++ b/tests/requirements/py3.txt
@@ -4,7 +4,7 @@ argon2-cffi >= 19.2.0
 backports.zoneinfo; python_version < '3.9'
 bcrypt
 black == 23.12.1
-docutils
+docutils < 0.22
 geoip2; python_version < '3.12'
 jinja2 >= 2.11.0
 numpy; python_version < '3.12'