From b10e6f9447cec5ee3afbe3c2a4a3e20140ff1754 Mon Sep 17 00:00:00 2001
From: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
Date: Tue, 22 Sep 2026 15:07:22 -0300
Subject: [PATCH 1/2] Pin Sphinx <9.0.0 in requirements.txt

Pin Sphinx version to avoid false positives caused by Sphinx 9.0.0+
---
 requirements.txt | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index cb26e1833..74b607fa8 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -4,7 +4,10 @@ urllib3
 potodo
 jinja2
 docutils
-sphinx
+# The Sphinx version is pinned so that new versions that introduce
+# new warnings won't suddenly cause build failures.
+# See https://github.com/sphinx-doc/sphinx/issues/14162
+sphinx<9.0.0
 python-docs-theme
 dacite
 sphinx-lint

From 0d77be12c2323cf4406c99758f982991867586ca Mon Sep 17 00:00:00 2001
From: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
Date: Tue, 22 Sep 2026 15:11:52 -0300
Subject: [PATCH 2/2] Remove warning about false-positives in Sphinx builds

This issue happens on Sphinx >= 9.0.0, but we pinned Sphinx<9.0.0
---
 templates/build-details.html.jinja | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/templates/build-details.html.jinja b/templates/build-details.html.jinja
index e74199355..93e9f6298 100644
--- a/templates/build-details.html.jinja
+++ b/templates/build-details.html.jinja
@@ -1,10 +1,5 @@
 {% extends "base.html.jinja" %}
 {% block main %}
-  <div class="alert alert-warning" role="alert">
-    <strong>Warning!</strong> There might be false positives in Sphinx build warnings! See
-    <a href="https://github.com/sphinx-doc/sphinx/issues/14162"
-       class="alert-link">sphinx#14162</a>.
-  </div>
   <table>
     <thead>
       <tr>