From bf87b818e85bcd862585c1d6675a5b7647785514 Mon Sep 17 00:00:00 2001
From: Zachary Ware <zachary.ware@gmail.com>
Date: Tue, 2 Nov 2021 11:58:34 -0500
Subject: [PATCH] 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