From 0a5fb1f92d9cfb4810d8940b20d5a00cc3226341 Mon Sep 17 00:00:00 2001
From: Anton Goloborodko <goloborodko.anton@gmail.com>
Date: Wed, 18 Dec 2024 10:39:42 +0100
Subject: [PATCH] Update readthedocs.yml

---
 readthedocs.yml | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/readthedocs.yml b/readthedocs.yml
index 7f675f4..de01529 100644
--- a/readthedocs.yml
+++ b/readthedocs.yml
@@ -1,5 +1,16 @@
 
 # .readthedocs.yml
+
+# For some reason, readthedocs' platform does not import the installed package (from .../envs/),
+# but instead reads another copy from .../checkouts/. This other copy does not have compiled
+# cython objects and throws and error.
+# To overcome this issue, we had to use a custom job to install pairtools in the editable mode
+# and thus ensure that the cython code is compiled.
+# Another potentially useful trick in the future: setting environmental variables 
+# (e.g. PIP_VERBOSE and PIP_NO_BUILD_ISOLATION=false) can control pip's behaviour in
+# the standard install job.
+
+
 version: 2
 
 build:
@@ -12,12 +23,13 @@ build:
       - pip install --no-build-isolation -e .[doc]
       - python -c "import pairtools.lib.dedup_cython"
 
-sphinx:
-  configuration: doc/conf.py
-
 # python:
 #   install:
 #     - method: pip
 #       path: .
 #       extra_requirements:
 #         - doc
+
+sphinx:
+  configuration: doc/conf.py
+