From c01c78b8483225030c6798a80ec63b5c567f2643 Mon Sep 17 00:00:00 2001
From: aramissennyeydd <aramis.sennyey@doordash.com>
Date: Sun, 13 Apr 2025 18:07:40 -0400
Subject: [PATCH] chore: start building new api reference docs alongside
 existing build

Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>
---
 .github/workflows/deploy_microsite.yml | 34 +++++++++++++++++++++++++-
 .github/workflows/verify_microsite.yml | 30 +++++++++++++++++++++++
 2 files changed, 63 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/deploy_microsite.yml b/.github/workflows/deploy_microsite.yml
index ff49b94e56..6e59381f46 100644
--- a/.github/workflows/deploy_microsite.yml
+++ b/.github/workflows/deploy_microsite.yml
@@ -80,6 +80,17 @@ jobs:
           if-no-files-found: error
           retention-days: 1
 
+      - name: build API reference (beta)
+        run: yarn backstage-repo-tools package-docs
+
+      - name: upload API reference (beta)
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: stable-reference-beta
+          path: type-docs/
+          if-no-files-found: error
+          retention-days: 1
+
       - name: microsite yarn install
         run: yarn install --immutable
         working-directory: microsite
@@ -136,6 +147,17 @@ jobs:
           if-no-files-found: error
           retention-days: 1
 
+      - name: build API reference (beta)
+        run: yarn backstage-repo-tools package-docs
+
+      - name: upload API reference (beta)
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: next-reference-beta
+          path: type-docs/
+          if-no-files-found: error
+          retention-days: 1
+
         # Also build and upload storybook
       - name: storybook yarn install
         run: yarn install --immutable
@@ -265,8 +287,18 @@ jobs:
           name: storybook
           path: microsite/build/storybook
 
+      - uses: actions/download-artifact@95815c38cf2ff2164869cbab79da8d1f422bc89e # v4
+        with:
+          name: stable-reference-beta
+          path: microsite/build/api/stable/
+
+      - uses: actions/download-artifact@95815c38cf2ff2164869cbab79da8d1f422bc89e # v4
+        with:
+          name: next-reference-beta
+          path: microsite/build/api/next/
+
       - name: Check the build output
-        run: ls microsite/build && ls microsite/build/storybook
+        run: ls microsite/build && ls microsite/build/storybook && ls microsite/build/api/stable && ls microsite/build/api/next
 
       - name: Deploy both microsite and storybook to gh-pages
         uses: JamesIves/github-pages-deploy-action@62fec3add6773ec5dbbf18d2ee4260911aa35cf4 # v4.6.9
diff --git a/.github/workflows/verify_microsite.yml b/.github/workflows/verify_microsite.yml
index ce3be0cf42..8142592aaa 100644
--- a/.github/workflows/verify_microsite.yml
+++ b/.github/workflows/verify_microsite.yml
@@ -85,6 +85,15 @@ jobs:
           if-no-files-found: error
           retention-days: 1
 
+      - name: build API reference (beta)
+        run: yarn backstage-repo-tools package-docs
+
+      - name: upload API reference (beta)
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: stable-reference-beta
+          path: type-docs/
+
       - name: microsite yarn install
         run: yarn install --immutable
         working-directory: microsite
@@ -140,6 +149,15 @@ jobs:
           if-no-files-found: error
           retention-days: 1
 
+      - name: build API reference (beta)
+        run: yarn backstage-repo-tools package-docs
+
+      - name: upload API reference (beta)
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: next-reference-beta
+          path: type-docs/
+
         # Also build and upload storybook
       - name: storybook yarn install
         run: yarn install --immutable
@@ -271,3 +289,15 @@ jobs:
       - name: build microsite
         run: yarn build
         working-directory: microsite
+
+      - name: download stable reference (beta)
+        uses: actions/download-artifact@95815c38cf2ff2164869cbab79da8d1f422bc89e # v4
+        with:
+          name: stable-reference-beta
+          path: api/stable/
+
+      - name: download next reference (beta)
+        uses: actions/download-artifact@95815c38cf2ff2164869cbab79da8d1f422bc89e # v4
+        with:
+          name: next-reference-beta
+          path: api/next/