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

@@ -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

.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