From 6204ce04b8459ebca063ee2f54bd71be11ca42ad Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Sun, 6 Aug 2023 17:50:05 +0200
Subject: [PATCH] Draft attempt to migrate to Sphinx 7

The rtd theme we use sphinx-rtd-theme removed the limits that
blocked us from using Sphinx 7 as tracked in the issue:

* https://github.com/readthedocs/sphinx_rtd_theme/pull/1464

This is the first attempt to update Sphinx to newer version and
build our documentation.
---
 setup.py | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/setup.py b/setup.py
index 6f29dc1f4705..d6da594d64d9 100644
--- a/setup.py
+++ b/setup.py
@@ -299,18 +299,14 @@ def write_version(filename: str = str(AIRFLOW_SOURCES_ROOT / "airflow" / "git_ve
     # click 8.1.4 and 8.1.5 generate mypy errors due to typing issue in the upstream package:
     # https://github.com/pallets/click/issues/2558
     "click>=8.0,!=8.1.4,!=8.1.5",
-    # Docutils 0.17.0 converts generated <div class="section"> into <section> and breaks our doc formatting
-    # By adding a lot of whitespace separation. This limit can be lifted when we update our doc to handle
-    # <section> tags for sections
-    "docutils<0.17.0",
     "eralchemy2",
-    "sphinx-airflow-theme",
+    "sphinx-airflow-theme>=0.1.1b1",
     "sphinx-argparse>=0.1.13",
     "sphinx-autoapi>=2.0.0",
     "sphinx-copybutton",
     "sphinx-jinja>=2.0",
-    "sphinx-rtd-theme>=0.1.6",
-    "sphinx>=5.2.0",
+    "sphinx-rtd-theme==1.3.0rc1",
+    "sphinx>=7.0.0",
     "sphinxcontrib-httpdomain>=1.7.0",
     "sphinxcontrib-redoc>=1.6.0",
     "sphinxcontrib-spelling>=7.3",