From f7ad4051c2486dad15c799cbec669646bd8c5271 Mon Sep 17 00:00:00 2001
From: Aramis Sennyey <159921952+aramissennyeydd@users.noreply.github.com>
Date: Mon, 26 Jan 2026 09:31:14 -0700
Subject: [PATCH] fix: add missing file for docsite builds (#32526)

* fix: add missing file for docsite builds

Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>

* create directory

Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>

---------

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

diff --git a/.github/workflows/deploy_microsite.yml b/.github/workflows/deploy_microsite.yml
index de394b8385..ea6ab36249 100644
--- a/.github/workflows/deploy_microsite.yml
+++ b/.github/workflows/deploy_microsite.yml
@@ -244,11 +244,25 @@ jobs:
           name: stable-openapi-docs
           path: docs
 
-      - name: grab lastest releases docs
+      - name: grab latest releases docs
         run: |
           git fetch origin master --depth 1
           git checkout FETCH_HEAD -- docs/releases
 
+      - name: create missing generated file
+        run: |
+          mkdir -p docs/reference
+          cat > docs/reference/index.md <<EOF
+          ---
+          id: 'index'
+          title: 'Package Index'
+          description: 'Index of all Backstage Packages'
+          ---
+
+          Please use [the new API documentation](https://backstage.io/api/stable) for more information.
+
+          EOF
+
       - name: generate stable docs
         run: yarn docusaurus docs:version stable
         working-directory: microsite
diff --git a/.github/workflows/verify_microsite.yml b/.github/workflows/verify_microsite.yml
index 5e6ea86182..19e575cf46 100644
--- a/.github/workflows/verify_microsite.yml
+++ b/.github/workflows/verify_microsite.yml
@@ -251,11 +251,25 @@ jobs:
           name: stable-openapi-docs
           path: docs
 
-      - name: grab lastest releases docs
+      - name: grab latest releases docs
         run: |
           git fetch origin master --depth 1
           git checkout FETCH_HEAD -- docs/releases
 
+      - name: create missing generated file
+        run: |
+          mkdir -p docs/reference
+          cat > docs/reference/index.md <<EOF
+          ---
+          id: 'index'
+          title: 'Package Index'
+          description: 'Index of all Backstage Packages'
+          ---
+
+          Please use [the new API documentation](https://backstage.io/api/stable) for more information.
+
+          EOF
+
       - name: generate stable docs
         run: yarn docusaurus docs:version stable
         working-directory: microsite