From 4b1fa367eb54eca85902775f927b8eb38d98ee68 Mon Sep 17 00:00:00 2001 From: ThotDjehuty Date: Tue, 12 May 2026 14:42:35 +0200 Subject: [PATCH] =?UTF-8?q?ci(rtd):=20docs-only=20build=20=E2=80=94=20drop?= =?UTF-8?q?=20pip=20install=20.=20and=20openblas=20apt=20dep?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit RTD builds were failing because openblas-build 0.10.16 (transitively pulled by ndarray-linalg via openblas-src) requires ureq tls feature flags it does not enable. Cargo.lock is gitignored so RTD always resolves fresh and hits the broken upstream version. Building the Rust extension on RTD is unnecessary: the Sphinx pages do not use autodoc against the Python module, and all inline plots under doc samples are pre-rendered PNGs committed to docs/source/_static/auto/ by the local scripts/inject_doc_plots.py author-time pipeline. This commit makes the RTD job render-only: install docs/requirements.txt and run Sphinx. No Rust toolchain, no maturin, no OpenBLAS. --- .readthedocs.yaml | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 24ccda5..f68681a 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -7,8 +7,6 @@ build: os: ubuntu-22.04 tools: python: "3.11" - apt_packages: - - libopenblas-dev sphinx: configuration: docs/source/conf.py @@ -20,5 +18,9 @@ formats: python: install: - requirements: docs/requirements.txt - - method: pip - path: . +# Note: we intentionally do NOT `pip install .` on RTD. +# The Sphinx build only renders RST/MD pages and pre-generated PNG plots +# committed under docs/source/_static/. Building the Rust extension on RTD +# requires OpenBLAS + maturin and routinely breaks because of upstream +# `openblas-build` / `ureq` feature changes. All inline plots are pre-rendered +# locally via scripts/inject_doc_plots.py and committed to the repo.