diff --git a/docs/doc-requirements.txt b/docs/doc-requirements.txt
index 9d97767661..19f9313150 100644
--- a/docs/doc-requirements.txt
+++ b/docs/doc-requirements.txt
@@ -2,6 +2,7 @@ ipykernel
 jinja2
 jupyter_client
 jupyter_server
+mistune<1.0.0
 myst-parser
 nbformat
 prometheus_client
diff --git a/docs/environment.yml b/docs/environment.yml
index dda583469d..66dbbfbde0 100644
--- a/docs/environment.yml
+++ b/docs/environment.yml
@@ -5,3 +5,4 @@ dependencies:
   - pip
   - pip:
       - -r doc-requirements.txt
+      - ..
diff --git a/readthedocs.yml b/readthedocs.yml
index 011118fd63..3e388237dc 100644
--- a/readthedocs.yml
+++ b/readthedocs.yml
@@ -3,9 +3,3 @@ sphinx:
   configuration: docs/source/conf.py
 conda:
   environment: docs/environment.yml
-python:
-  version: 3.8
-  install:
-    # install itself with pip install .
-    - method: pip
-      path: .