Merge pull request #2143 from consideRatio/pr/unpin-docs-deps

docs: unpin python dependencies, use ubuntu 22.04 build context on RTD

.readthedocs.yaml

@@ -5,11 +5,15 @@
 version: 2
 
 build:
-  os: ubuntu-20.04
+  os: ubuntu-22.04
   tools:
-    # NOTE: This must be miniconda or it will mistakenly try to invoke `python` to do a conda install
-    # ref: https://stackoverflow.com/questions/69774313/why-does-rtd-run-python-env-create-instead-of-conda-env-create-when-building
-    python: "miniconda3-4.7"
+    # We need to specify that we require Python to be setup with conda/mamba to
+    # work against an `conda.environment` file, so we specify mambaforge here.
+    #
+    # ref: https://github.com/readthedocs/readthedocs.org/issues/8595
+    # ref: https://docs.readthedocs.io/en/stable/config-file/v2.html#build-tools-python
+    #
+    python: "mambaforge-4.10"
 
 sphinx:
   configuration: docs/conf.py

docs/environment.yml

@@ -2,7 +2,7 @@ name: infrastructure-docs
 channels:
   - conda-forge
 dependencies:
-  - go-terraform-docs=0.15.0
+  - go-terraform-docs
   - python=3.10
   - pip:
       - -r requirements.txt

docs/requirements.txt

@@ -1,8 +1,8 @@
-myst-parser[sphinx,linkify]==0.18.0
-pandas==1.5.0
-pyyaml==6.0
-requests==2.28.1
-sphinx-autobuild==2021.3.14
-sphinx-copybutton==0.5.0
-sphinx-design==0.3.0
+myst-parser[sphinx,linkify]
+pandas
+pyyaml
+requests
+sphinx-autobuild
+sphinx-copybutton
+sphinx-design
 git+https://github.com/2i2c-org/sphinx-2i2c-theme