Commit 25bf002
fix(deps): downgrade Sphinx to 8.1.3 for Python 3.10 compatibility
Resolve ReadTheDocs build failure caused by Sphinx version incompatibility.
**Root Cause**:
- .readthedocs.yaml specifies Python 3.10 (aligns with pyproject.toml minimum)
- requirements.txt had Sphinx==8.2.3 (requires Python >=3.11)
- Incompatibility: Sphinx 8.2.3 cannot install on Python 3.10
**Changes**:
- requirements.txt: Sphinx 8.2.3 → 8.1.3 (Python 3.10 compatible)
- requirements-dev.txt: Add version constraint `sphinx>=7.3,<8.2`
(prevents future freezes from re-introducing incompatibility)
**Validation**:
- Local docs build: SUCCESS (7 pre-existing warnings, no errors)
- Sphinx 8.1.3 compatible with Python 3.10+
- docstring-inheritance extension: Loads correctly
**Context**:
Previous commit (0a0ce18) correctly added docstring-inheritance to docs
and aligned .readthedocs.yaml with Python 3.10 minimum, but exposed
latent Sphinx version incompatibility from automated requirements freeze.
This fix ensures:
- RTD builds succeed with Python 3.10 + Sphinx 8.1.3
- Future freezes stay within compatible range
- Documentation requirements align with package minimum Python version
Refs: https://readthedocs.org/projects/solarwindpy/builds/
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>1 parent 0a0ce18 commit 25bf002
2 files changed
Lines changed: 2 additions & 2 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
19 | 19 | | |
20 | 20 | | |
21 | 21 | | |
22 | | - | |
| 22 | + | |
23 | 23 | | |
24 | 24 | | |
25 | 25 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
7 | | - | |
| 7 | + | |
8 | 8 | | |
9 | 9 | | |
10 | 10 | | |
| |||
0 commit comments