feat: update yaml rendering

.github/workflows/gh-actions-to-azure-deployment.yml

@@ -0,0 +1,89 @@
+# This workflow is discontinued due to limitations in github build agents (1GB space limit)
+
+name: Build and deploy ASP.Net Core app to Azure Web App - docs-next
+on:
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write 
+      contents: read 
+
+
+    steps:
+      - name: Checkout docs-next
+        uses: actions/checkout@v4
+
+      - name: Checkout contribution repo
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+          repository: SuperOfficeDocs/contribution
+          path: ClientApp/external-content/contribution
+
+      - name: Checkout SuperOfficeDocs repo
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+          repository: SuperOfficeDocs/superoffice-docs
+          path: ClientApp/external-content/superoffice-docs
+
+      # Set up .NET
+      - name: Set up .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.x'
+
+      # Set up Node.js (for Astro build)
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.x'
+          cache: 'npm'
+          cache-dependency-path: 'ClientApp/package-lock.json'
+
+      - name: Publish project (runs npm + copies frontend via MSBuild target)
+        working-directory: ./Server
+        run: dotnet publish -c Release -o ${{env.DOTNET_ROOT}}/out
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: dotnet-artifact
+          path: ${{env.DOTNET_ROOT}}/out
+
+  deploy:
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name == 'push' || github.event_name == 'workflow_dispatch'
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - name: Download build artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: dotnet-artifact
+          path: ./publish
+
+      - name: Create deployment ZIP
+        run: |
+          cd publish
+          zip -r ../app.zip .
+          cd ..
+
+      - name: Azure Login (OIDC)
+        uses: azure/login@v2
+        with:
+          client-id: ${{ secrets.AZUREAPPSERVICE_CLIENTID_7D6201BE9CBA4102A67082079FA9D045 }}
+          tenant-id: ${{ secrets.AZUREAPPSERVICE_TENANTID_E5F979726F2140149EE71D82B31CE225 }}
+          subscription-id: ${{ secrets.AZUREAPPSERVICE_SUBSCRIPTIONID_3F73E186A6F2462480840A28C77242B0 }}
+
+      - name: Deploy ZIP to Azure Web App
+        uses: azure/webapps-deploy@v3
+        with:
+          app-name: 'docs-next'
+          package: ./app.zip

.github/workflows/deploy.yml → .github/workflows/gh-pages-deploy.yml

@@ -1,39 +1,33 @@
-# workflow for deploying astro project to GitHub Pages
 name: Build & Deploy docs-next to Github Pages
 
 on:
-  # Runs on pull requests and manual invocations for targeted bran
+  # Runs only when a pull request targets deploy-to-github-pages
   pull_request:
+    branches:
+      - deploy-to-github-pages
 
-  # Allows you to run this workflow manually from the Actions tab
+  # Allows manual run
   workflow_dispatch:
     inputs:
       target_branch:
         description: 'Branch to run the workflow on'
         required: false
         default: ''
 
-  # Runs on pushes targeting the default branch
+  # Runs only on pushes to deploy-to-github-pages
   push:
-    branches: ["main"]
+    branches:
+      - deploy-to-github-pages
 
-# 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:
   group: "pages"
   cancel-in-progress: false
 
-# Application is built using 2 jobs which focuses on different content files.
-# build-main is built using every content except en/api and build-api only build with en/api content.
-# Both build jobs clones 3 repos - SuperOfficeDocs/docs-next, SuperOfficeDocs/superoffice-docs, SuperOfficeDocs/contribution
-# Both build jobs outputs respective artifacts - artifact-main and artifact-api
-
 jobs:
   build-main:
     runs-on: ubuntu-latest
@@ -48,29 +42,33 @@ jobs:
         with:
           fetch-depth: 1
           repository: SuperOfficeDocs/contribution
-          path: external-content/contribution
+          path: ClientApp/external-content/contribution
+
       - name: Checkout SuperOfficeDocs repo
         uses: actions/checkout@v4
         with:
           fetch-depth: 1
           repository: SuperOfficeDocs/superoffice-docs
-          path: external-content/superoffice-docs
+          path: ClientApp/external-content/superoffice-docs
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: 22
           cache: 'npm'
+          cache-dependency-path: ClientApp/package-lock.json
 
       - run: npm ci
+        working-directory: ClientApp
 
       - name: Build Astro excluding API
+        working-directory: ClientApp
         env:
           API_ONLY: 'false'
         run: |
           npm run build
-          mkdir -p dist-out
-          cp -r dist/* dist-out/
+          mkdir -p ../dist-out
+          cp -r dist/* ../dist-out/
 
       - name: Upload main artifact
         uses: actions/upload-artifact@v4
@@ -93,38 +91,40 @@ jobs:
         with:
           fetch-depth: 1
           repository: SuperOfficeDocs/contribution
-          path: external-content/contribution
+          path: ClientApp/external-content/contribution
 
       - name: Checkout SuperOfficeDocs repo
         uses: actions/checkout@v4
         with:
           fetch-depth: 1
           repository: SuperOfficeDocs/superoffice-docs
-          path: external-content/superoffice-docs
+          path: ClientApp/external-content/superoffice-docs
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: 22
           cache: 'npm'
+          cache-dependency-path: ClientApp/package-lock.json
 
       - run: npm ci
+        working-directory: ClientApp
 
       - name: Build Astro API only
+        working-directory: ClientApp
         env:
           API_ONLY: 'true'
         run: |
           npm run build
-          mkdir -p dist-out
-          cp -r dist/* dist-out/
+          mkdir -p ../dist-out
+          cp -r dist/* ../dist-out/
 
       - name: Upload API artifact
         uses: actions/upload-artifact@v4
         with:
           name: artifact-api
           path: dist-out
 
-  # deploy job downloads artifacts from build jobs, merge them in to one directory, create search index, and deploy to github pages
   deploy:
     needs: [build-main, build-api]
     runs-on: ubuntu-latest
@@ -163,7 +163,7 @@ jobs:
 
       - name: Index pages using Pagefind
         run: npx pagefind --site final-dist
-      
+
       - name: Check if the PR originates from source repo
         id: check_pr_source
         run: |
@@ -188,4 +188,4 @@ jobs:
       - name: Deploy to GitHub Pages
         if: steps.check_pr_source.outputs.skip_deploy == 'false'
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,15 +1,31 @@
+.vs
+.vscode/
+
 # build output
-dist/
+out
+
+ClientApp/dist/
 
-.distA/
-.distB/
+ClientApp/.distA/
+ClientApp/.distB/
 
 
 # generated types
-.astro/
+ClientApp/.astro/
 
 # dependencies
-node_modules/
+ClientApp/node_modules/
+
+# Build Log
+ClientApp/build.log
+
+
+# .NET
+Server/bin/
+Server/obj/
+Server/wwwroot/
+Server/publish/
+
 
 # logs
 npm-debug.log*
@@ -19,8 +35,8 @@ pnpm-debug.log*
 
 
 # environment variables
-.env
-.env.production
+ClientApp/.env
+ClientApp/.env.production
 
 # macOS-specific files
 .DS_Store
@@ -32,12 +48,12 @@ pnpm-debug.log*
 .vscode/settings.json
 
 # Playwright
-e2e-tests/test-results/
-e2e-tests/playwright-report/
-e2e-tests/blob-report/
-e2e-tests/playwright/.cache/
+ClientApp/e2e-tests/test-results/
+ClientApp/e2e-tests/playwright-report/
+ClientApp/e2e-tests/blob-report/
+ClientApp/e2e-tests/playwright/.cache/
 
 # External content (other GitHub repos)
 
-external-content/
-public/downloads/
+ClientApp/external-content/
+ClientApp/public/downloads/