pydata · dhruvak001 · Jul 12, 2025 · Jul 12, 2025 · Jul 12, 2025 · Jul 12, 2025
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
@@ -14,6 +14,9 @@ build:
       - git fetch --unshallow || true
     pre_install:
       - git update-index --assume-unchanged doc/conf.py ci/requirements/doc.yml
+      - export NO_COLOR=1
+      - export TERM=dumb
+      - export FORCE_COLOR=0
 
 conda:
   environment: ci/requirements/doc.yml

diff --git a/ci/requirements/doc.yml b/ci/requirements/doc.yml
@@ -41,12 +41,12 @@ dependencies:
   - sphinx-copybutton
   - sphinx-design
   - sphinx-inline-tabs
-  - sphinx>=6,<8
   - sphinxcontrib-mermaid
   - sphinxcontrib-srclinks
   - sphinx-remove-toctrees
   - sphinxext-opengraph
   - sphinxext-rediraffe
+  - tree # for zarr docs
   - zarr
   - pip:
       # relative to this file. Needs to be editable to be accepted.

diff --git a/doc/user-guide/complex-numbers.rst b/doc/user-guide/complex-numbers.rst
diff --git a/doc/user-guide/index.rst b/doc/user-guide/index.rst
@@ -29,16 +29,23 @@ examples that describe many common tasks that you can accomplish with Xarray.
 
 .. toctree::
    :maxdepth: 2
-   :caption: I/O
+   :caption: Reading and Writing Files
 
    io
-   complex-numbers
+   io-netcdf-hdf
+   io-zarr
+   io-other-formats
+
 
 .. toctree::
    :maxdepth: 2
-   :caption: Visualization
+   :caption: Plotting
 
    plotting
+   plotting-lines
+   plotting-2d
+   plotting-faceting
+   plotting-datasets
 
 
 .. toctree::