From af1a675c458bd73ebd7caa975edf1fe3b29afac3 Mon Sep 17 00:00:00 2001
From: James Lamb <jlamb@nvidia.com>
Date: Fri, 21 Feb 2025 14:48:17 -0600
Subject: [PATCH] require sphinx<8.2.0 (#1119)

Contributes to https://github.com/rapidsai/build-planning/issues/155

Fixes docs builds by temporarily putting a ceiling on `sphinx`.

## Notes for Reviewers

In case you're wondering why you don't see `dependencies.yaml` changes... this project uses readthedocs to builds its docs.

* builds: https://app.readthedocs.org/projects/ucx-py/builds/
* config: https://github.com/rapidsai/ucx-py/blob/674e731c21e3a85045239a943248b23dab019619/.readthedocs.yml#L16-L17

Authors:
  - James Lamb (https://github.com/jameslamb)

Approvers:
  - Bradley Dice (https://github.com/bdice)

URL: https://github.com/rapidsai/ucx-py/pull/1119
---
 conda/environments/builddocs.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/conda/environments/builddocs.yml b/conda/environments/builddocs.yml
index 14419853..c159d943 100644
--- a/conda/environments/builddocs.yml
+++ b/conda/environments/builddocs.yml
@@ -4,8 +4,8 @@ channels:
 - nvidia
 - conda-forge
 dependencies:
-# required for building docs
-- sphinx
+# the ceiling on sphinx can be removed when https://github.com/spatialaudio/nbsphinx/issues/825 is resolved
+- sphinx>=8.0,<8.2.0
 - sphinx-markdown-tables
 - sphinx_rtd_theme
 - sphinxcontrib-websupport