ci: provide manual deployment of TypeDoc

Author: danielwiehl

.github/workflows/manual-workflow.publish-documentation.yml renamed to .github/workflows/manual-workflow.publish-developer-guide.yml

@@ -1,4 +1,4 @@
-name: Documentation Publication
+name: Publish Developer Guide
 on: workflow_dispatch
 env:
   NODE_VERSION: 20.14.0
@@ -20,7 +20,7 @@ jobs:
       - if: steps.node-modules-cache.outputs.cache-hit != 'true'
         run: npm ci
   publish-documentation:
-    name: 'Publishing Documentation'
+    name: 'Publishing Developer Guide'
     needs: install
     runs-on: ubuntu-latest
     steps:
@@ -38,9 +38,9 @@ jobs:
         id: package-json
         with:
           path: projects/scion/microfrontend-platform/package.json
-      - name: 'Building Reference Documentation (Developer Guide)'
+      - name: 'Building Developer Guide'
         run: npm run microfrontend-platform:adoc -- -a revnumber=${{ steps.package-json.outputs.version }} -a revnumber-dasherized=${{ steps.package-json.outputs.version-dasherized }}
-      - name: 'Deploying Reference Documentation (Developer Guide) to Vercel'
+      - name: 'Publishing Developer Guide to Vercel'
         uses: SchweizerischeBundesbahnen/scion-toolkit/.github/actions/vercel-deploy@master
         with:
           dist-folder: dist/microfrontend-platform-developer-guide

.github/workflows/manual-workflow.publish-typedoc.yml

@@ -0,0 +1,48 @@
+name: Publish TypeDoc
+on: workflow_dispatch
+env:
+  NODE_VERSION: 20.14.0
+jobs:
+  install:
+    name: 'Installing NPM modules'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+      - name: 'Caching NPM modules if necessary'
+        uses: actions/cache@v4
+        id: node-modules-cache
+        with:
+          path: ./node_modules
+          key: node_modules-${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
+      - if: steps.node-modules-cache.outputs.cache-hit != 'true'
+        run: npm ci
+  publish-documentation:
+    name: 'Publishing TypeDoc'
+    needs: install
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+      - name: 'Restoring NPM modules from cache'
+        uses: actions/cache@v4
+        with:
+          path: ./node_modules
+          key: node_modules-${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
+      - name: 'Building TypeDoc'
+        run: npm run microfrontend-platform:typedoc
+      - name: 'Publishing TypeDoc to Vercel'
+        uses: SchweizerischeBundesbahnen/scion-toolkit/.github/actions/vercel-deploy@master
+        with:
+          dist-folder: dist/microfrontend-platform-api
+          vercel-token: ${{ secrets.VERCEL_TOKEN }}
+          org-id: ${{ secrets.VERCEL_ORG_ID }}
+          project-id: ${{ secrets.VERCEL_MICROFRONTEND_PLATFORM_API_PROJECT_ID }}
+          version: ${{ needs.build-platform.outputs.version }}
+          aliases: |
+            microfrontend-platform-api.scion.vercel.app,
+            microfrontend-platform-api-v%v.scion.vercel.app