From 14e20b22c6c3c5d770afe753277104388ce8149a Mon Sep 17 00:00:00 2001
From: Ryan Blue <ryanzblue@gmail.com>
Date: Sat, 31 May 2025 13:08:30 -0400
Subject: [PATCH 1/2] Clean up CI

---
 .github/actions/install-docs/action.yml | 25 +++++++++
 .github/workflows/static.yml            | 70 +++++++++++--------------
 2 files changed, 55 insertions(+), 40 deletions(-)
 create mode 100644 .github/actions/install-docs/action.yml

diff --git a/.github/actions/install-docs/action.yml b/.github/actions/install-docs/action.yml
new file mode 100644
index 0000000000000..49695101f82fe
--- /dev/null
+++ b/.github/actions/install-docs/action.yml
@@ -0,0 +1,25 @@
+name: 'Install API docs'
+description: 'Pull and install allwpilib API docs from a given git ref'
+inputs:
+  ref:
+    description: 'git ref to pull API docs from'
+    required: true
+  path:
+    description: 'path to place API docs in'
+    required: true
+runs:
+  using: 'composite'
+  steps:
+    - name: Checkout docs
+      uses: actions/checkout@v4
+      with:
+        ref: ${{ inputs.ref }}
+        path: tmp/${{ inputs.ref }}
+    - name: Finalize location
+      shell: bash
+      run: |
+        rm -rf ${{ inputs.path }}/java ${{ inputs.path }}/cpp
+        mkdir -p ${{ inputs.path }}
+        mv tmp/${{ inputs.ref }}/javadoc ${{ inputs.path }}/java
+        mv tmp/${{ inputs.ref }}/doxygen/html ${{ inputs.path }}/cpp
+        rm -rf tmp
diff --git a/.github/workflows/static.yml b/.github/workflows/static.yml
index ec6135a952962..57e48ee8b0ae4 100644
--- a/.github/workflows/static.yml
+++ b/.github/workflows/static.yml
@@ -2,19 +2,13 @@
 name: Deploy static content to Pages
 
 on:
-  # Runs on pushes targeting the source branches
+  # Runs on pushes targeting the main branch
   push:
-    branches: ["main", "allwpilib-development", "allwpilib-release", "allwpilib-beta"]
+    branches: ["main"]
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
 # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
 # However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
 concurrency:
@@ -22,59 +16,55 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
-  # Single deploy job since we're just deploying
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
+  assemble:
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout main
-        uses: actions/checkout@v4
-        with:
-          ref: main
-      - name: Checkout allwpilib-release
+      - name: Checkout branch
         uses: actions/checkout@v4
+      - name: Install release
+        uses: ./.github/actions/install-docs
         with:
           ref: allwpilib-release
           path: allwpilib/docs/release
-      - name: Checkout allwpilib-beta
-        uses: actions/checkout@v4
+      - name: Install beta
+        uses: ./.github/actions/install-docs
         with:
           ref: allwpilib-beta
           path: allwpilib/docs/beta
-      - name: Checkout allwpilib-development
-        uses: actions/checkout@v4
+      - name: Install development
+        uses: ./.github/actions/install-docs
         with:
           ref: allwpilib-development
           path: allwpilib/docs/development
-      - name: Finalize directory locations
-        run: |
-          rm -rf allwpilib/docs/release/java allwpilib/docs/release/cpp
-          mv allwpilib/docs/release/javadoc allwpilib/docs/release/java
-          mv allwpilib/docs/release/doxygen/html allwpilib/docs/release/cpp
-          rm -rf allwpilib/docs/beta/java allwpilib/docs/beta/cpp
-          mv allwpilib/docs/beta/javadoc allwpilib/docs/beta/java
-          mv allwpilib/docs/beta/doxygen/html allwpilib/docs/beta/cpp
-          rm -rf allwpilib/docs/development/java allwpilib/docs/development/cpp
-          mv allwpilib/docs/development/javadoc allwpilib/docs/development/java
-          mv allwpilib/docs/development/doxygen/html allwpilib/docs/development/cpp
       - run: wget -O favicon.ico https://raw.githubusercontent.com/wpilibsuite/branding/main/export/ico/wpilib-icon-256.ico
-      - name: Get pages url
-        run: echo url=$(gh api "repos/${{ github.repository }}/pages" --jq '.html_url') >> $GITHUB_ENV
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Setup Pages
+        id: configure-pages
+        uses: actions/configure-pages@v5
+        continue-on-error: ${{ github.repository != 'wpilibsuite/wpilibsuite.github.io'}}
       - name: Install sitemap generator
         run: npm install -g static-sitemap-cli@^2.2.5
+        if: ${{ steps.configure-pages.outcome == 'success' }}
       - name: Generate sitemap
-        run: static-sitemap-cli --base ${{ env.url }} --root . --ignore "allwpilib/docs/beta/**" "allwpilib/docs/development/**" --changefreq  "**,monthly" "allwpilib/docs/**,weekly" --verbose --no-clean
-      - name: Setup Pages
-        uses: actions/configure-pages@v5
+        run: static-sitemap-cli --base ${{ steps.configure-pages.outputs.base_url }} --root . --ignore "allwpilib/docs/beta/**" "allwpilib/docs/development/**" --changefreq  "**,monthly" "allwpilib/docs/**,weekly" --verbose --no-clean
+        if: ${{ steps.configure-pages.outcome == 'success' }}
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
           # Upload entire repository
           path: '.'
+
+  deploy:
+    needs: assemble
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+      # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    runs-on: ubuntu-latest
+    steps:
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4

From 1888b056146792db9c8b2a18fdde68d8aa7ce721 Mon Sep 17 00:00:00 2001
From: Ryan Blue <ryanzblue@gmail.com>
Date: Sat, 31 May 2025 14:56:31 -0400
Subject: [PATCH 2/2] Add 2027 docs

---
 .github/workflows/static.yml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/static.yml b/.github/workflows/static.yml
index 57e48ee8b0ae4..9f216f21e310e 100644
--- a/.github/workflows/static.yml
+++ b/.github/workflows/static.yml
@@ -36,6 +36,11 @@ jobs:
         with:
           ref: allwpilib-development
           path: allwpilib/docs/development
+      - name: Install 2027
+        uses: ./.github/actions/install-docs
+        with:
+          ref: allwpilib-2027
+          path: allwpilib/docs/2027
       - run: wget -O favicon.ico https://raw.githubusercontent.com/wpilibsuite/branding/main/export/ico/wpilib-icon-256.ico
       - name: Setup Pages
         id: configure-pages
@@ -45,7 +50,7 @@ jobs:
         run: npm install -g static-sitemap-cli@^2.2.5
         if: ${{ steps.configure-pages.outcome == 'success' }}
       - name: Generate sitemap
-        run: static-sitemap-cli --base ${{ steps.configure-pages.outputs.base_url }} --root . --ignore "allwpilib/docs/beta/**" "allwpilib/docs/development/**" --changefreq  "**,monthly" "allwpilib/docs/**,weekly" --verbose --no-clean
+        run: static-sitemap-cli --base ${{ steps.configure-pages.outputs.base_url }} --root . --ignore "allwpilib/docs/beta/**" "allwpilib/docs/development/**" "allwpilib/docs/2027/**" --changefreq  "**,monthly" "allwpilib/docs/**,weekly" --verbose --no-clean
         if: ${{ steps.configure-pages.outcome == 'success' }}
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3