From f0fc7e8824fe9a93e817c5a7bc1d73f3c9af3ad1 Mon Sep 17 00:00:00 2001 From: Zachary Ware Date: Tue, 2 Nov 2021 19:41:50 -0500 Subject: [PATCH] Reorder installation in .readthedocs.yaml (#825) * 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. * Update .readthedocs.yaml Co-authored-by: Brian Rutledge --- .readthedocs.yaml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 2151c3dd..83c0eeca 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -16,7 +16,10 @@ formats: python: # Mininum supported Python version version: "3.6" + # 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: - - requirements: docs/requirements.txt - method: pip path: . + - requirements: docs/requirements.txt