From 8bc83d30fc306dd6181e5ea408867e417fcbe753 Mon Sep 17 00:00:00 2001
From: Zach Hannum <zach.hannum@posit.co>
Date: Tue, 13 Jan 2026 13:46:58 +0000
Subject: [PATCH 1/4] Run pkgdown workflow on PR as dry run to test docs

---
 .github/workflows/pkgdown.yaml | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/pkgdown.yaml b/.github/workflows/pkgdown.yaml
index 6890f37..458faba 100644
--- a/.github/workflows/pkgdown.yaml
+++ b/.github/workflows/pkgdown.yaml
@@ -3,6 +3,10 @@ on:
     branches:
       - main
       - master
+  pull_request:
+    branches:
+      - main
+      - master
 
 name: pkgdown
 
@@ -52,7 +56,13 @@ jobs:
       - name: Install package
         run: R CMD INSTALL .
 
-      - name: Build and deploy pkgdown site
+      - name: Build pkgdown site
+        if: github.event_name == 'pull_request'
+        run: |
+          Rscript -e 'pkgdown::build_site()'
+
+      - name: Deploy pkgdown site
+        if: github.event_name == 'push'
         run: |
           git config --local user.name "$GITHUB_ACTOR"
           git config --local user.email "$GITHUB_ACTOR@users.noreply.github.com"

From aeaf9e18cdcd3d2bca390dbc46ebbb73508572f0 Mon Sep 17 00:00:00 2001
From: Zach Hannum <zach.hannum@posit.co>
Date: Tue, 13 Jan 2026 14:21:31 +0000
Subject: [PATCH 2/4] Update GitHub Actions to use latest versions of checkout,
 R, Pandoc, and cache actions

---
 .github/workflows/pkgdown.yaml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/pkgdown.yaml b/.github/workflows/pkgdown.yaml
index 458faba..3048acf 100644
--- a/.github/workflows/pkgdown.yaml
+++ b/.github/workflows/pkgdown.yaml
@@ -18,12 +18,12 @@ jobs:
       GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
-      - uses: r-lib/actions/setup-r@v1
+      - uses: r-lib/actions/setup-r@v2
         id: install-r
 
-      - uses: r-lib/actions/setup-pandoc@v1
+      - uses: r-lib/actions/setup-pandoc@v2
 
       - name: Install pak and query dependencies
         run: |
@@ -32,7 +32,7 @@ jobs:
         shell: Rscript {0}
 
       - name: Restore R package cache
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: |
             ${{ env.R_LIBS_USER }}/*

From d9fe547620e157204f3378e8c9eadc79198c8943 Mon Sep 17 00:00:00 2001
From: Zach Hannum <zach.hannum@posit.co>
Date: Tue, 13 Jan 2026 14:33:04 +0000
Subject: [PATCH 3/4] Update pkgdown workflow to use Ubuntu 22.04 and updated
 RSPM URL

---
 .github/workflows/pkgdown.yaml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/pkgdown.yaml b/.github/workflows/pkgdown.yaml
index 3048acf..8b3bb7a 100644
--- a/.github/workflows/pkgdown.yaml
+++ b/.github/workflows/pkgdown.yaml
@@ -12,9 +12,9 @@ name: pkgdown
 
 jobs:
   pkgdown:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
     env:
-      RSPM: https://packagemanager.rstudio.com/cran/__linux__/jammy/latest
+      RSPM: https://packagemanager.posit.co/cran/__linux__/jammy/latest
       GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
 
     steps:
@@ -37,14 +37,14 @@ jobs:
           path: |
             ${{ env.R_LIBS_USER }}/*
             !${{ env.R_LIBS_USER }}/pak
-          key: ubuntu-latest-${{ steps.install-r.outputs.installed-r-version }}-1-${{ hashFiles('.github/r-depends.rds') }}
-          restore-keys: ubuntu-latest-${{ steps.install-r.outputs.installed-r-version }}-1-
+          key: ubuntu-22.04-${{ steps.install-r.outputs.installed-r-version }}-1-${{ hashFiles('.github/r-depends.rds') }}
+          restore-keys: ubuntu-22.04-${{ steps.install-r.outputs.installed-r-version }}-1-
 
       - name: Install system dependencies
         if: runner.os == 'Linux'
         run: |
-          pak::local_system_requirements(execute = TRUE)
-          pak::pkg_system_requirements("pkgdown", execute = TRUE)
+          pak::pkg_sysreqs("local::.", execute = TRUE)
+          pak::pkg_sysreqs("pkgdown", execute = TRUE)
         shell: Rscript {0}
 
       - name: Install dependencies

From 92d29fd79e927a8541111034f670b726a9bb36f7 Mon Sep 17 00:00:00 2001
From: Zach Hannum <zach.hannum@posit.co>
Date: Tue, 13 Jan 2026 14:37:11 +0000
Subject: [PATCH 4/4] Use setup-r-dependencies action

---
 .github/workflows/pkgdown.yaml | 29 +++--------------------------
 1 file changed, 3 insertions(+), 26 deletions(-)

diff --git a/.github/workflows/pkgdown.yaml b/.github/workflows/pkgdown.yaml
index 8b3bb7a..c97b54e 100644
--- a/.github/workflows/pkgdown.yaml
+++ b/.github/workflows/pkgdown.yaml
@@ -25,33 +25,10 @@ jobs:
 
       - uses: r-lib/actions/setup-pandoc@v2
 
-      - name: Install pak and query dependencies
-        run: |
-          install.packages("pak", repos = "https://r-lib.github.io/p/pak/dev/")
-          saveRDS(pak::pkg_deps("local::.", dependencies = TRUE), ".github/r-depends.rds")
-        shell: Rscript {0}
-
-      - name: Restore R package cache
-        uses: actions/cache@v4
+      - uses: r-lib/actions/setup-r-dependencies@v2
         with:
-          path: |
-            ${{ env.R_LIBS_USER }}/*
-            !${{ env.R_LIBS_USER }}/pak
-          key: ubuntu-22.04-${{ steps.install-r.outputs.installed-r-version }}-1-${{ hashFiles('.github/r-depends.rds') }}
-          restore-keys: ubuntu-22.04-${{ steps.install-r.outputs.installed-r-version }}-1-
-
-      - name: Install system dependencies
-        if: runner.os == 'Linux'
-        run: |
-          pak::pkg_sysreqs("local::.", execute = TRUE)
-          pak::pkg_sysreqs("pkgdown", execute = TRUE)
-        shell: Rscript {0}
-
-      - name: Install dependencies
-        run: |
-          pak::local_install_dev_deps(upgrade = TRUE, dependencies = c("all", "Config/Needs/website"))
-          pak::pkg_install("pkgdown")
-        shell: Rscript {0}
+          extra-packages: any::pkgdown, local::.
+          needs: website
 
       - name: Install package
         run: R CMD INSTALL .