Merge branch 'main' of https://github.com/BmanClark/arm-learning-paths

Author: BmanClark

.github/copilot-instructions.md

@@ -1,6 +1,6 @@
 # Install Guide Review Tracker
 
-Progress: 0 / 97 reviewed
+Progress: 43 / 98 reviewed
 
 Legend: [x] reviewed | [ ] not started | 🔒 hidden/not published
 
@@ -12,55 +12,56 @@ Legend: [x] reviewed | [ ] not started | 🔒 hidden/not published
 |-------|-------|-----------|--------------|----------|
 | skopeo | Skopeo | ✓ | 2025-02-05 | [ ] |
 | aws-cli | AWS CLI | ✓ | 2025-02-05 | [ ] |
-| helm | Helm | ✓ | 2025-02-05 | [ ] |
-| py-woa | Python for Windows on Arm | ✓ | 2025-02-05 | [ ] |
-| sysbox | Sysbox | ✓ | 2025-02-05 | [ ] |
-| eksctl | AWS EKS CLI (eksctl) | ✓ | 2025-02-10 | [ ] |
+| helm | Helm | ✓ | 2025-02-05 | [x] |
+| py-woa | Python for Windows on Arm | ✓ | 2025-02-05 | [x] |
+| sysbox | Sysbox | ✓ | 2025-02-05 | [x] |
+| eksctl | eksctl (Amazon EKS CLI) | ✓ | 2025-02-10 | [x] |
 | kubectl | Kubectl | ✓ | 2025-02-10 | [ ] |
-| bedrust | Bedrust - invoke models on Amazon Bedrock | ✓ | 2025-04-10 | [ ] |
-| anaconda | Anaconda | ✓ | 2025-04-25 | [ ] |
+| bedrust | Bedrust - invoke models on Amazon Bedrock | ✓ | 2025-04-10 | [x] |
+| anaconda | Anaconda | ✓ | 2025-04-25 | [x] |
 | ansible | Ansible | ✓ | 2025-04-25 | [ ] |
-| armie | Arm Instruction Emulator (armie) | ✓ | 2025-04-25 | [ ] |
+| armie | Arm Instruction Emulator (armie) | ✓ | 2025-04-25 | [x] |
 | aws-copilot | AWS Copilot CLI | ✓ | 2025-04-25 | [ ] |
 | gcloud | Google Cloud Platform (GCP) CLI | ✓ | 2025-04-25 | [ ] |
 | nerdctl | Nerdctl | ✓ | 2025-04-25 | [ ] |
 | papi | Performance API (PAPI) | ✓ | 2025-04-25 | [ ] |
 | perf | Perf for Linux on Arm (LinuxPerf) | ✓ | 2025-04-25 | [ ] |
-| pulumi | Pulumi | ✓ | 2025-04-25 | [ ] |
-| terraform | Terraform | ✓ | 2025-04-25 | [ ] |
+| pulumi | Pulumi | ✓ | 2025-04-25 | [x] |
+| terraform | Terraform | ✓ | 2025-04-25 | [x] |
 | topdown-tool | Telemetry Solution (Topdown Methodology) | ✓ | 2025-04-25 | [ ] |
-| cmake | CMake | ✓ | 2025-04-26 | [ ] |
-| docker/ | Docker (multi-page) | ✓ | 2025-04-26 | [ ] |
+| cmake | CMake | ✓ | 2025-04-26 | [x] |
+| docker/ | Docker (multi-page) | ✓ | 2025-04-26 | [x] |
 | hyper-v | Hyper-V on Arm | ✓ | 2025-04-26 | [ ] |
 | aws_access_keys | AWS Credentials | ✓ | 2025-04-30 | [ ] |
 | aws-sam-cli | AWS SAM CLI | ✓ | 2025-04-30 | [ ] |
 | azure_login | Azure Authentication | ✓ | 2025-04-30 | [ ] |
-| porting-advisor | Porting Advisor for Graviton | ✓ | 2025-04-30 | [ ] |
+| porting-advisor | Porting Advisor for Graviton | ✓ | 2025-04-30 | [x] |
 | vscode-tunnels | VS Code Tunnels | ✓ | 2025-04-30 | [ ] |
 | ssh | SSH | ✓ | 2025-05-02 | [ ] |
-| finch | Finch on Arm Linux | ✓ | 2025-05-22 | [ ] |
+| finch | Finch on Arm Linux | ✓ | 2025-05-22 | [x] |
 | browsers/ | Browsers on Arm (multi-page) | ✓ | 2025-06-18 | [ ] |
-| go | Go | ✓ | 2025-07-16 | [ ] |
-| nomachine | NoMachine | ✓ | 2025-07-16 | [ ] |
-| powershell | PowerShell | ✓ | 2025-07-16 | [ ] |
-| swift | Swift | ✓ | 2025-07-16 | [ ] |
-| oc | OpenShift CLI (oc) | ✓ | 2025-07-24 | [ ] |
-| tkn | Tekton CLI (tkn) | ✓ | 2025-07-24 | [ ] |
+| go | Go | ✓ | 2025-07-16 | [x] |
+| nomachine | NoMachine | ✓ | 2025-07-16 | [x] |
+| powershell | PowerShell | ✓ | 2025-07-16 | [x] |
+| swift | Swift | ✓ | 2025-07-16 | [x] |
+| oc | OpenShift CLI (oc) | ✓ | 2025-07-24 | [x] |
+| tkn | Tekton CLI (tkn) | ✓ | 2025-07-24 | [x] |
 | azure-cli | Azure CLI | ✓ | 2025-07-28 | [ ] |
 | pytorch | PyTorch | ✓ | 2025-10-14 | [ ] |
-| multipass | Multipass | ✓ | 2025-10-17 | [ ] |
+| multipass | Multipass | ✓ | 2025-10-17 | [x] |
 | vnc | VNC on Arm Linux | ✓ | 2025-11-24 | [ ] |
 | kiro-cli | Kiro CLI | ✓ | 2025-12-10 | [ ] |
 | linux-migration-tools | Arm Linux Migration Tools | ✓ | 2026-01-08 | [ ] |
-| aperf | APerf | ✓ | 2026-01-19 | [ ] |
-| gcc/ | GNU Compiler (multi-page) | ✓ | 2026-01-28 | [ ] |
-| gemini | Gemini CLI | ✓ | 2026-01-30 | [ ] |
-| java | Java | ✓ | 2026-01-30 | [ ] |
-| openvscode-server | OpenVSCode Server | ✓ | 2026-01-30 | [ ] |
+| aperf | APerf | ✓ | 2026-01-19 | [x] |
+| gcc/ | GNU Compiler (multi-page) | ✓ | 2026-01-28 | [x] |
+| gemini | Gemini CLI | ✓ | 2026-01-30 | [x] |
+| java | Java | ✓ | 2026-01-30 | [x] |
+| openvscode-server | OpenVSCode Server | ✓ | 2026-01-30 | [x] |
 | sbt | sbt | ✓ | 2026-01-30 | [ ] |
-| wperf | WindowsPerf (wperf) | ✓ | 2026-01-30 | [ ] |
-| asct | Arm System Characterization Tool | 🔒 hidden | 2026-02-06 | [ ] |
-| git-woa | Git for Windows on Arm | ✓ | 2026-02-26 | [ ] |
+| wperf | WindowsPerf (wperf) | ✓ | 2026-01-30 | [x] |
+| asct | Arm System Characterization Tool | 🔒 hidden | 2026-02-06 | [x] |
+| git-woa | Git for Windows on Arm | ✓ | 2026-02-26 | [x] |
+| flatpak | Flatpak | ✓ | 2026-04-20 | [x] |
 | dotnet | .NET SDK | ✓ | 2026-03-02 | [ ] |
 
 ---
@@ -77,18 +78,18 @@ Legend: [x] reviewed | [ ] not started | 🔒 hidden/not published
 | mdk | Arm Keil uVision | ✓ | 2025-04-25 | [ ] |
 | socrates | Arm Socrates | ✓ | 2025-04-25 | [ ] |
 | successkits | Arm Success Kits | ✓ | 2025-04-25 | [ ] |
-| armclang | Arm Compiler for Embedded | ✓ | 2025-04-26 | [ ] |
+| armclang | Arm Compiler for Embedded | ✓ | 2025-04-26 | [x] |
 | avh | Arm Virtual Hardware | ✓ | 2025-04-26 | [ ] |
 | keilstudio_vs | Arm Keil Studio for VS Code | ✓ | 2025-04-26 | [ ] |
 | license/ | Arm Software Licensing (multi-page) | ✓ | 2025-04-26 | [ ] |
 | streamline | Arm Streamline | ✓ | 2025-04-26 | [ ] |
-| llvm-embedded | LLVM Embedded Toolchain for Arm | ✓ | 2025-04-30 | [ ] |
+| llvm-embedded | LLVM Embedded Toolchain for Arm | ✓ | 2025-04-30 | [x] |
 | rust_embedded | Rust for Embedded Applications | ✓ | 2025-04-30 | [ ] |
 | ams | Arm Performance Studio | ✓ | 2025-08-08 | [ ] |
 | fm_fvp/ | Arm Fast Models and FVPs (multi-page) | ✓ | 2025-08-20 | [ ] |
 | stm32_vs | STM32 extensions for VS Code | ✓ | 2025-12-18 | [ ] |
 | mcuxpresso_vs | NXP MCUXpresso for VS Code | ✓ | 2026-01-14 | [ ] |
-| cmsis-toolbox | CMSIS-Toolbox | ✓ | 2026-01-30 | [ ] |
+| cmsis-toolbox | CMSIS-Toolbox | ✓ | 2026-01-30 | [x] |
 
 ---
 
@@ -97,23 +98,23 @@ Legend: [x] reviewed | [ ] not started | 🔒 hidden/not published
 | Guide | Title | Published | Last Updated | Reviewed |
 |-------|-------|-----------|--------------|----------|
 | windows-sandbox-woa | Windows Sandbox for Windows on Arm | ✓ | 2025-04-25 | [ ] |
-| llvm-woa | LLVM toolchain for Windows on Arm | ✓ | 2025-04-30 | [ ] |
+| llvm-woa | LLVM toolchain for Windows on Arm | ✓ | 2025-04-30 | [x] |
 | github-copilot | GitHub Copilot | ✓ | 2025-12-16 | [ ] |
 | claude-code | Claude Code | ✓ | 2026-01-15 | [ ] |
-| pytorch-woa | PyTorch for Windows on Arm | ✓ | 2026-01-30 | [ ] |
+| pytorch-woa | PyTorch for Windows on Arm | ✓ | 2026-01-30 | [x] |
 | atp | Arm Total Performance | 🔒 hidden | 2026-02-06 | [ ] |
 | vs-woa | Visual Studio for Windows on Arm | ✓ | 2026-02-26 | [ ] |
-| armpl | Arm Performance Libraries | ✓ | 2026-03-02 | [ ] |
+| armpl | Arm Performance Libraries | ✓ | 2026-03-02 | [x] |
 
 ---
 
 ## Florent Lebeau (3 guides)
 
 | Guide | Title | Published | Last Updated | Reviewed |
 |-------|-------|-----------|--------------|----------|
-| forge | Linaro Forge | ✓ | 2025-04-30 | [ ] |
+| forge | Linaro Forge | ✓ | 2025-04-30 | [x] |
 | gfortran | GFortran | ✓ | 2025-04-30 | [ ] |
-| acfl | Arm Compiler for Linux | ✓ | 2026-01-29 | [ ] |
+| acfl | Arm Compiler for Linux | ✓ | 2026-01-29 | [x] |
 
 ---
 
@@ -125,13 +126,13 @@ Legend: [x] reviewed | [ ] not started | 🔒 hidden/not published
 | ros2 | ROS - Robot Operating System | Odin Shen | ✓ | 2025-04-25 | [ ] |
 | oci-cli | Oracle Cloud Infrastructure (OCI) CLI | Daniel Gubay | ✓ | 2025-04-26 | [ ] |
 | aws-greengrass-v2 | AWS IoT Greengrass | Michael Hall | ✓ | 2025-05-02 | [ ] |
-| dcperf | DCPerf | Kieran Hejmadi | ✓ | 2025-09-22 | [ ] |
-| container | Container CLI for macOS | Rani Chowdary Mandepudi | ✓ | 2025-09-29 | [ ] |
-| bolt | BOLT | Jonathan Davies | ✓ | 2025-10-22 | [ ] |
+| dcperf | DCPerf | Kieran Hejmadi | ✓ | 2025-09-22 | [x] |
+| container | Container CLI for macOS | Rani Chowdary Mandepudi | ✓ | 2025-09-29 | [x] |
+| bolt | BOLT | Jonathan Davies | ✓ | 2025-10-22 | [x] |
 | arduino-pico | Arduino core for the Raspberry Pi Pico | Michael Hall | ✓ | 2025-11-11 | [ ] |
-| windows-perf-vs-extension | Visual Studio Extension for WindowsPerf | Nader Zouaoui | ✓ | 2025-11-11 | [ ] |
-| windows-perf-wpa-plugin | Windows Performance Analyzer (WPA) plugin | Alaaeddine Chakroun | ✓ | 2025-12-02 | [ ] |
+| windows-perf-vs-extension | Visual Studio Extension for WindowsPerf | Nader Zouaoui | ✓ | 2025-11-11 | [x] |
+| windows-perf-wpa-plugin | Windows Performance Analyzer (WPA) plugin | Alaaeddine Chakroun | ✓ | 2025-12-02 | [x] |
 | streamline-cli | Streamline CLI Tools | Julie Gaskin | ✓ | 2025-12-18 | [ ] |
-| codex-cli | Codex CLI | Joe Stech | ✓ | 2026-01-08 | [ ] |
+| codex-cli | Codex CLI | Joe Stech | ✓ | 2026-01-08 | [x] |
 | fvps-on-macos | AVH FVPs on macOS | Christopher Seidl | ✓ | 2026-01-16 | [ ] |
 | rust | Rust for Linux Applications | Mathias Brossard | ✓ | 2026-01-26 | [ ] |

.github/dependabot.yml

@@ -1,45 +1,17 @@
-### Maintenance checks for Learning Paths and Install Guides
- 
-Please review the content in the specified content path and support my manual review by:
- 
-1. **Summarizing what this guide does**
-   - What the end goal is
-   - What platform(s) and environments it targets
-   - Any key assumptions the reader must meet
- 
-2. **Identifying dependencies and moving parts**
-   - OS, architecture, toolchains, frameworks, SDKs
-   - External repositories, models, downloads, or services
-   - Commands or workflows that are central to the guide
- 
-3. **Flagging potential risk areas**
-   - References to old OS versions, runtimes, or toolchains
-   - Dependencies that may be stale, deprecated, or fragile
-   - Links or resources that might require checking
-   - Steps that rely heavily on UI flows or screenshots
- 
-4. **Calling out anything that may need a closer human look**
-   - Ambiguous or unclear instructions
-   - Areas where “latest” or unpinned versions are used
-   - Places where ecosystem changes could affect correctness
- 
----
- 
-### How to behave
- 
-- Be conservative and transparent — if something is uncertain, say so.
-- Prefer **flagging** over **fixing**.
-- Do not invent new commands, tools, or workflows.
-- If suggesting changes, keep them minimal and clearly optional.
-- Treat this as a *conversation starter* for the reviewer, not a final verdict.
- 
----
- 
-### Output format (keep it lightweight)
- 
-Please respond with:
-- A short summary of the guide
-- A bulleted list of dependencies
-- A bulleted list of review flags or questions to consider
- 
-No code changes are required unless I explicitly ask for them.
+# Maintenance review guidance
+
+Use `.github/skills/stale-content-review/SKILL.md` for stale-content risk scans and maintenance triage.
+
+The skill includes:
+
+- A periodic scan workflow for Learning Paths and install guides.
+- A deterministic script for finding likely stale-content signals.
+- Reference guidance for interpreting temporal wording, screenshots, mutable dependencies, external links, old dates, and version-sensitive content.
+
+For one-off manual reviews, run:
+
+```bash
+python3 .github/skills/stale-content-review/scripts/stale_content_scan.py <content-path>
+```
+
+No content changes are required unless explicitly requested.

.github/install-guide-review.md

@@ -0,0 +1,102 @@
+---
+name: audit-images
+description: Audit and fix Markdown image alt text in Arm Learning Paths and install guides. Use when the user asks to review images, find deficient alt text, count faulty images, run project-level or path-level image audits, track before/after image quality, or update image alt text and captions against repository image guidance.
+---
+
+# Audit images
+
+## Description
+
+Audit Markdown image references in Arm Learning Paths and install guides, report deficient alt text and image syntax, and help fix alt text with useful instructional descriptions.
+
+Use the script for repeatable inventory and counting. Use assistant judgment for semantic alt-text quality and final edits.
+
+## Prerequisites
+
+- Work from the repository root.
+- Read `AGENTS.md` to locate shared guidance.
+- Read `references/image-guidance.md` before editing image alt text, captions, or image syntax.
+
+## Trigger
+
+Use this skill when the user asks to:
+
+- Audit images or alt text.
+- Find placeholder, vague, missing, malformed, or duplicated alt text.
+- Count faulty images across the project or inside one Path/guide.
+- Track image audit counts before and after fixes.
+- Fix image alt text, captions, or `#center` syntax.
+
+## Review levels
+
+### Project-level review
+
+Scan all Learning Paths and install guides unless the user gives a narrower scope.
+
+Use project-level review to:
+
+- Count total image references and faulty image references.
+- Group faults by content unit and issue type.
+- Identify high-priority directories or files for cleanup.
+- Produce a before/after baseline for tracking progress.
+
+Don't mass-edit the whole project unless the user explicitly asks. Prefer reporting the project-level inventory and then fixing one Path, guide, category, or batch.
+
+### Path/guide-level review
+
+Scan one Learning Path directory, install guide file, or install guide directory.
+
+Use path/guide-level review to:
+
+- List each faulty image with file, line, image path, current alt text, caption, and issue type.
+- Inspect surrounding Markdown context before changing alt text.
+- View local images when visual inspection is needed.
+- Fix alt text and syntax in place.
+- Re-run the audit and report before/after counts.
+
+## Workflow
+
+1. Identify whether the requested scope is project-level or path/guide-level.
+2. Run `.github/skills/audit-images/scripts/audit_images.py` on that scope.
+3. Record the baseline summary: total images, faulty images, content units affected, and issue counts.
+4. Depending on the request level, do the following:
+  - For project-level requests, summarize the results and suggest prioritized cleanup batches unless the user asked for edits.
+  - For path/guide-level edit requests, inspect the relevant Markdown context and image files.
+5. Suggest rewrites for deficient alt text using `references/image-guidance.md`.
+6. After the reviewer accepts suggestions, rewrite text, then re-run the audit on the same scope.
+7. Report before/after counts, files changed, and any remaining issues.
+
+## Validation rules
+
+- Treat the script as a detector, not the final authority. It flags likely problems for review.
+- Use `references/image-guidance.md` as the source of truth for alt text, captions, placeholder text, `#center` syntax, and figure numbering.
+- Don't replace meaningful alt text only because it is long or short; judge whether it helps the learner complete the task.
+- Preserve valid local image paths and existing captions unless they are wrong, vague, or outdated.
+- Preserve repository image syntax unless syntax cleanup is the target of the edit.
+
+## Error handling
+
+- If the script reports a missing local image path, verify whether the path is site-root-relative, file-relative, or intentionally external before changing content.
+- If an image cannot be inspected, fix only issues that can be resolved from surrounding Markdown context and state the limitation.
+- If project-level results are too large to edit safely, report the inventory and recommend a smaller batch.
+- If the audit script and visual/context review disagree, explain the judgment and leave a short note in the final response.
+
+## Script usage
+
+Run a project-level audit:
+
+```bash
+python3 .github/skills/audit-images/scripts/audit_images.py
+```
+
+Run a path-level audit:
+
+```bash
+python3 .github/skills/audit-images/scripts/audit_images.py content/learning-paths/servers-and-cloud-computing/example-path
+```
+
+Write JSON for tracking:
+
+```bash
+python3 .github/skills/audit-images/scripts/audit_images.py --format json --output image-audit.json
+```