From 014b26a3a957bef907c89f26b600ff13eb382682 Mon Sep 17 00:00:00 2001
From: "Jin Seok (Andy) Lee" <andyjinseoklee@gmail.com>
Date: Mon, 11 May 2026 16:56:28 -0400
Subject: [PATCH] update docs.yml

---
 .github/workflows/docs.yml | 39 +++++++++++++++++++++++++++++++++++---
 README.md                  |  4 ++--
 2 files changed, 38 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 1c9dfdb..d72a38d 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -17,14 +17,47 @@ concurrency:
 jobs:
   build:
     runs-on: ubuntu-latest
+    defaults:
+      run:
+        shell: bash -l {0}
     steps:
       - uses: actions/checkout@v4
 
-      - uses: actions/setup-python@v5
+      - name: Free disk space (Ubuntu)
+        uses: jlumbroso/free-disk-space@main
         with:
-          python-version: "3.12"
+          tool-cache: false
+          android: true
+          dotnet: true
+          haskell: true
+          large-packages: true
+          docker-images: true
+          swap-storage: true
 
-      - run: pip install pyyaml
+      - name: Set up Miniconda
+        uses: conda-incubator/setup-miniconda@v3
+        with:
+          miniconda-version: "latest"
+          activate-environment: docs-env
+          python-version: "3.10"
+          channels: conda-forge,bioconda,defaults
+          channel-priority: strict
+
+      - name: Install dependencies
+        run: |
+          conda install -y \
+            pip \
+            rust=1.88.0 \
+            pandas=2.2.3 \
+            polars=1.26.0 \
+            pyarrow=19.0.1 \
+            pyyaml
+          python -m pip install pysam==0.23.0
+          python -m pip install . --verbose
+
+      - name: Verify install
+        run: |
+          python -c "import exactolib; print('exactolib OK:', exactolib.__file__)"
 
       - uses: quarto-dev/quarto-actions/setup@v2
 
diff --git a/README.md b/README.md
index 174cf44..ff4b700 100644
--- a/README.md
+++ b/README.md
@@ -68,8 +68,8 @@ exacto <subcommand> --help
 | `translate-seqs`                | Translate transcript sequences into peptide sequences.       |
 | `translate-structs`             | Translate transcript structures into mutant proteoforms.     |
 
-See the [Commands reference](https://pirl-unc.github.io/exacto/cli/) for full
-parameter documentation, and the [Pipelines guide](https://pirl-unc.github.io/exacto/pipelines/)
+See the [Commands documentation](https://pirl-unc.github.io/exacto/cli/) for full
+parameter documentation, and the [Pipelines documentation](https://pirl-unc.github.io/exacto/pipelines/)
 for end-to-end mutant-proteoform-prediction and variation-graph-construction
 walkthroughs.