Final job verification

.devcontainer/Dockerfile

@@ -6,10 +6,10 @@ RUN apt-get update && \
     apt-get -y install vim wget sudo git 
 
 RUN case ${TARGETPLATFORM} in \
-         "linux/amd64")  HUGO=hugo_0.111.2_linux-amd64 ;; \
-         "linux/arm64")  HUGO=hugo_0.111.2_linux-arm64 ;; \
+         "linux/amd64")  HUGO=hugo_0.130.0_linux-amd64 ;; \
+         "linux/arm64")  HUGO=hugo_0.130.0_linux-arm64 ;; \
     esac \
-    && HUGO_VER=v0.111.2 \
+    && HUGO_VER=v0.130.0 \
     &&  wget https://github.com/gohugoio/hugo/releases/download/${HUGO_VER}/${HUGO}.deb && apt-get -y install ./${HUGO}.deb
 
 # User account

.devcontainer/devcontainer.json

@@ -7,6 +7,6 @@
 
     "remoteUser": "ubuntu",
 
-    "postStartCommand": "nohup bash -c 'hugo ; bin/pagefind --site public --output-subdir ../static/pagefind ; hugo server --baseUrl=/ --liveReloadPort=443 --appendPort=false --bind=0.0.0.0 &' "
+    "postStartCommand": "nohup bash -c 'hugo ; bin/pagefind --site public --output-subdir ../static/pagefind ; hugo server --baseURL=/ --liveReloadPort=443 --appendPort=false --bind=0.0.0.0 &' "
 
 }

.github/pull_request_template.md

@@ -2,7 +2,7 @@
 Before submitting a pull request for a new Learning Path, please review [Create a Learning Path](https://learn.arm.com//learning-paths/cross-platform/_example-learning-path/)
 - [ ] I have reviewed Create a Learning Path
 
-Please do not include any confidential information in your contribution. This includes confidential microarchitecture details and unannounced product information. No AI tool can be used to generate either content or code when creating a learning path or install guide.
+Please do not include any confidential information in your contribution. This includes confidential microarchitecture details and unannounced product information. 
 
 - [ ] I have checked my contribution for confidential information
 

.github/workflows/deploy.yml

@@ -19,14 +19,20 @@ on:
         required: true
       HUGO_RAG_API:
         required: true
+      HUGO_AUDIO_API:
+        required: true
+      HUGO_DEV_PROG_SIGNIUP_FORM_MUNCHKIN_ID:
+        required: true
+      HUGO_FORM_ID_FOR_PROGRAM_SIGNUP:
+        required: true
 
 env:
   HUGO_VERSION: 0.130.0
 
 jobs:
   build_and_deploy:
     # The type of runner that the job will run on
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04-arm
     permissions:
       id-token: write
       contents: read
@@ -43,7 +49,10 @@ jobs:
         with:
           hugo-version: ${{ env.HUGO_VERSION }}
           extended: true
-
+
+      - name: Clear npm cache
+        run: npm cache clean --force
+
       # Installs Post-CSS
       - name: Install Post-CSS
         run: npm install postcss-cli
@@ -59,10 +68,13 @@ jobs:
         run: |
           hugo --minify
           cp learn-image-sitemap.xml public/learn-image-sitemap.xml
-          bin/pagefind --site "public"
+          bin/pagefind.aarch64 --site "public"
         env:
           HUGO_LLM_API: ${{ secrets.HUGO_LLM_API }}
           HUGO_RAG_API: ${{ secrets.HUGO_RAG_API }}
+          HUGO_AUDIO_API: ${{ secrets.HUGO_AUDIO_API }}
+          HUGO_DEV_PROG_SIGNIUP_FORM_MUNCHKIN_ID: ${{ secrets.HUGO_DEV_PROG_SIGNIUP_FORM_MUNCHKIN_ID }}
+          HUGO_FORM_ID_FOR_PROGRAM_SIGNUP: ${{ secrets.HUGO_FORM_ID_FOR_PROGRAM_SIGNUP }}
 
       # Deploys website to AWS S3 and invalidate CloudFront Cache
       - name: Deploy to S3

.github/workflows/main.yml

@@ -23,3 +23,6 @@ jobs:
       AWS_OIDC_ROLE: ${{ secrets.AWS_OIDC_ROLE_INTERNAL }}
       HUGO_LLM_API: ${{ secrets.HUGO_LLM_API }}
       HUGO_RAG_API: ${{ secrets.HUGO_RAG_API }}
+      HUGO_AUDIO_API: ${{ secrets.HUGO_AUDIO_API }}
+      HUGO_DEV_PROG_SIGNIUP_FORM_MUNCHKIN_ID: ${{ secrets.HUGO_DEV_PROG_SIGNIUP_FORM_MUNCHKIN_ID }}
+      HUGO_FORM_ID_FOR_PROGRAM_SIGNUP: ${{ secrets.HUGO_FORM_ID_FOR_PROGRAM_SIGNUP }}

.github/workflows/production.yml

@@ -23,3 +23,6 @@ jobs:
       AWS_OIDC_ROLE: ${{ secrets.AWS_OIDC_ROLE_PRODUCTION }}
       HUGO_LLM_API: ${{ secrets.HUGO_LLM_API }}
       HUGO_RAG_API: ${{ secrets.HUGO_RAG_API }}
+      HUGO_AUDIO_API: ${{ secrets.HUGO_AUDIO_API }}
+      HUGO_DEV_PROG_SIGNIUP_FORM_MUNCHKIN_ID: ${{ secrets.HUGO_DEV_PROG_SIGNIUP_FORM_MUNCHKIN_ID }}
+      HUGO_FORM_ID_FOR_PROGRAM_SIGNUP: ${{ secrets.HUGO_FORM_ID_FOR_PROGRAM_SIGNUP }}

.github/workflows/stats-pr.yml

@@ -9,10 +9,10 @@ permissions:
   pull-requests: write
 jobs:
   stats-pr:
-    runs-on: arm-linux-runner
+    runs-on: ubuntu-24.04-arm
     steps:
         - name: Checkout main branch
-          uses: actions/checkout@v2
+          uses: actions/checkout@v4
           with:
             ref: main
         - name: Download stats report as artifact
@@ -21,19 +21,36 @@ jobs:
             # Run ID of the workflow that uploaded the artifact
             run-id: ${{ github.event.workflow_run.id }}
             github-token: ${{ github.token }}
+        - name: Check if artifact exists
+          run: |
+              if [ ! -d stats_current_test_info ]; then
+                  echo "No stats artifact found"
+                  echo "ARTIFACT_EXIST=false" >> "$GITHUB_ENV"
+              else
+                  echo "Stats artifact found"
+                  echo "ARTIFACT_EXIST=true" >> "$GITHUB_ENV"
+              fi
         - name: Move stats file
           # Unpack the artifact and move the stats file to the correct location
+          if: env.ARTIFACT_EXIST == 'true'
           run: |
               mv stats_current_test_info/stats_current_test_info.yml data/stats_current_test_info.yml
               rm -rf stats_current_test_info
+        - name: Set workflow link as environment variable
+          if: env.ARTIFACT_EXIST == 'true'
+          run: echo "WORKFLOW_URL=${{ github.event.workflow_run.workflow_url }}" >> $GITHUB_ENV
+        - name: Echo Workflow URL
+          if: env.ARTIFACT_EXIST == 'true'
+          run: echo $WORKFLOW_URL
         - name: Create Pull Request
           uses: peter-evans/create-pull-request@v6
-          if: success()
+          if: env.ARTIFACT_EXIST == 'true' && success()
           with:
             commit-message: Update stats_current_test_info.yml
             title: Update stats_current_test_info.yml
             body: |
               Update test result file with recent run
+              Triggered by workflow run ${ WORKFLOW_URL }
               Auto-generated by create-pull-request: https://github.com/peter-evans/create-pull-request
             branch: update-stats-current-test-info
-            base: main
+            base: main

.github/workflows/test-lp.yml

@@ -2,18 +2,34 @@ name: Test Learning Path
 on: pull_request
 jobs:
   Test-Pull-Request:
-    runs-on: arm-linux-runner
+    runs-on: ubuntu-24.04-arm
     steps:
       - name: Check out repository code
         uses: actions/checkout@v4
         with:
           ref: ${{ steps.vars.outputs.branch-name }}
+      - name: Run hugo command to test site builds
+        run: |
+          sudo apt-get install -y hugo
+          hugo
       - name: Get all changed markdown files
         id: changed-markdown-files
-        uses: tj-actions/changed-files@v44
+        uses: tj-actions/changed-files@v46
         with:
           files: |
              **.md
+      - name: Check for capital letters or spaces in content directory
+        run: |
+          echo "Checking for capital letters or spaces in content directory paths..."
+
+          git diff --name-only origin/${{ github.base_ref }}...HEAD |
+            grep '^content/' |
+            grep -E '[A-Z]|[[:space:]]' && {
+              echo "❌ Found invalid file or directory names with capital letters or spaces in 'content/'"
+              exit 1
+            }
+
+          echo "✅ No capital letters or spaces found in 'content/' paths."
       - name: Install dependencies
         if: steps.changed-markdown-files.outputs.any_changed == 'true'
         run: pip install -r tools/requirements.txt
@@ -22,7 +38,7 @@ jobs:
         if: steps.changed-markdown-files.outputs.any_changed == 'true'
         # Run the test suite
         run: |
-            set -o pipefail; ./tools/test_lp.sh ${{ steps.changed-markdown-files.outputs.all_changed_files }} 2>&1 | tee test-lp-output.txt
+              set -o pipefail; ./tools/test_lp.sh ${{ steps.changed-markdown-files.outputs.all_changed_files }} 2>&1 | tee test-lp-output.txt
       - name: Parse test suite errors
         id: test-suite-state
         if: success()
@@ -51,4 +67,4 @@ jobs:
         if: success() && env.MAINTENANCE == 'on'
         with:
           name: stats_current_test_info
-          path: data/stats_current_test_info.yml
+          path: data/stats_current_test_info.yml

.github/workflows/update-roadmap-project-dates.yml

@@ -0,0 +1,110 @@
+name: Update Project Fields on Label and Status Change
+
+on:
+  pull_request:
+    types:
+      - labeled
+  workflow_dispatch:
+
+jobs:
+  update-project-dates:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v3
+
+      - name: Run GitHub Script
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}  # replace with your token secret name
+          script: |
+            const projectId = "PVT_kwDOBVR2-M4A2QVf"; // Replace with your actual project node ID
+            const fieldStartId = "PVTF_lADOBVR2-M4A2QVfzgrvSF4"; // Replace with Start Date field node ID
+            const fieldPublishId = "PVTF_lADOBVR2-M4A2QVfzgrvSMA"; // Replace with Publish Date field node ID
+
+            const label = context.payload.label ? context.payload.label.name : null;
+
+            if (!label) {
+            console.log("No label found in the payload.");
+            return;
+            }
+            const prNodeId = context.payload.pull_request.node_id;
+
+            // Get the project item for this PR
+            const { repository } = await github.graphql(`
+              query($owner: String!, $repo: String!, $prNumber: Int!) {
+                repository(owner: $owner, name: $repo) {
+                  pullRequest(number: $prNumber) {
+                   projectItems(first: 10) {
+                    nodes {
+                      id
+                      fieldValues(first: 10) {
+                        nodes {
+                          field {
+                            name
+                          }
+                          ... on ProjectV2ItemFieldDateValue {
+                            date
+                          }
+                          ... on ProjectV2ItemFieldTextValue {
+                            text
+                          }
+                          ... on ProjectV2ItemFieldSingleSelectValue {
+                            name
+                          }
+                        }
+                      }
+                    }
+                  }      
+
+            `, {
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              prNumber: context.issue.number,
+            });
+
+            const item = repository.pullRequest.projectItems.nodes[0];
+            if (!item) {
+              console.log("No project item found for this PR.");
+              return;
+            }
+
+            const itemId = item.id;
+
+            const today = new Date().toISOString().split("T")[0]; // e.g., "2025-04-10"
+
+            if (label === "awaiting_tech_review") {
+              console.log("Setting Start Date...");
+              await github.graphql(`
+                mutation {
+                  updateProjectV2ItemFieldValue(input: {
+                    projectId: "${projectId}",
+                    itemId: "${itemId}",
+                    fieldId: "${fieldStartId}",
+                    value: { date: "${today}" }
+                  }) {
+                    projectV2Item {
+                      id
+                    }
+                  }
+                }
+              `);
+            }
+
+            if (label === "publish") {
+              console.log("Setting Publish Date...");
+              await github.graphql(`
+                mutation {
+                  updateProjectV2ItemFieldValue(input: {
+                    projectId: "${projectId}",
+                    itemId: "${itemId}",
+                    fieldId: "${fieldPublishId}",
+                    value: { date: "${today}" }
+                  }) {
+                    projectV2Item {
+                      id
+                    }
+                  }
+                }
+              `);
+            }

.gitignore

@@ -6,9 +6,20 @@ node_modules/
 package-lock.json
 .hugo_build.lock
 .vscode
+.env
+startup.sh
 
 # macOS files
 *.DS_Store
 nohup.out
 
-venv/
+venv/
+z_local_saved/
+/.idea/
+/tools/.python-version
+/.python-version
+*.iml
+*.xml
+
+# CTags symbol index
+tags