From 6fd9c01159aeba132d7b0f7ef3949dd0049a0392 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Fri, 28 May 2021 15:19:13 +0200
Subject: [PATCH] Pins docutils to <0.17 until breaking behaviour is fixed
 (#16133)

Sphinx RTD theme 0.5.2. introduced limitation to docutils to account for
some docutils markup change:

https://github.com/readthedocs/sphinx_rtd_theme/issues/1112
---
 setup.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index f92a42269c93d..0448e694418dd 100644
--- a/setup.py
+++ b/setup.py
@@ -502,7 +502,12 @@ def get_sphinx_theme_version() -> str:
     'bowler',
     'click~=7.1',
     'coverage',
-    'docutils',
+    # Sphinx RTD theme 0.5.2. introduced limitation to docutils to account for some docutils markup
+    # change:
+    #      https://github.com/readthedocs/sphinx_rtd_theme/issues/1112
+    # This limitation can be removed after this issue is closed:
+    #      https://github.com/readthedocs/sphinx_rtd_theme/issues/1115
+    'docutils<0.17',
     'filelock',
     'flake8>=3.6.0',
     'flake8-colors',