From bf87b818e85bcd862585c1d6675a5b7647785514 Mon Sep 17 00:00:00 2001 From: Zachary Ware Date: Tue, 2 Nov 2021 11:58:34 -0500 Subject: [PATCH 1/2] Reverse the order of install directives in RTD config When RTD installs `.`, it uses `--upgrade-strategy eager`. If this is done after installing from `docs/requirements.txt`, packages may be upgraded that shouldn't be; currently, `docutils` gets upgraded to 0.18, which current versions of `Sphinx` can't work with. --- .readthedocs.yaml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 2151c3dd..e7df84dc 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -16,7 +16,8 @@ formats: python: # Mininum supported Python version version: "3.6" + # NB: install . first to avoid upgrading past docs/requirements.txt pins install: - - requirements: docs/requirements.txt - method: pip path: . + - requirements: docs/requirements.txt From 288c5c800af283c202ada0ba7d656ea3cde14316 Mon Sep 17 00:00:00 2001 From: Brian Rutledge Date: Wed, 3 Nov 2021 00:36:03 +0000 Subject: [PATCH 2/2] Update .readthedocs.yaml --- .readthedocs.yaml | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index e7df84dc..83c0eeca 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -16,7 +16,9 @@ formats: python: # Mininum supported Python version version: "3.6" - # NB: install . first to avoid upgrading past docs/requirements.txt pins + # Install twine first, because RTD uses `--upgrade-strategy eager`, + # which installs the latest version of docutils via readme_renderer. + # However, Sphinx 4.2.0 requires docutils>=0.14,<0.18. install: - method: pip path: .