Install guide updates for clarity and software versions

.github/copilot-instructions.md

@@ -103,7 +103,7 @@ Do not modify fixed template fields.
 
 If `multi_install` is set to true, the first page must act as an overview for the series. Sub-pages must set `multitool_install_part: true`.
 
-### Required content structure
+#### Required content structure
 
 Install guides should include:
 
@@ -127,7 +127,7 @@ Install guides should include:
 Optional:
 - Uninstall instructions
 
-### Scope boundaries
+#### Scope boundaries
 
 Install guides must not include:
 - End-to-end workflows
@@ -137,6 +137,14 @@ Install guides must not include:
 
 Learning Paths may link to install guides for setup steps. Install guides should not duplicate workflow content.
 
+#### Tool versions
+
+When providing commands for downloading or installing software, use a specific version in the example. This ensures that the instructions are accurate and verifiable. However, also include a note before the commands that tells readers the same commands work with other versions. Provide a link to where the latest version can be found. The note can be formatted as follows:
+
+{{% notice Note %}}
+The following commands use <tool> version <version>. The same commands work with other versions. Replace the file used in these steps with the file for your version of choice. To find the latest version, see [Link to page with release info](URL).
+{{% /notice %}}
+
 ### Further reading curation
 
 Limit `further_reading` resources to four to six essential links. Prioritize:
@@ -288,10 +296,16 @@ Use these preferred terms and phrases for consistency:
   - `therefore` instead of `ergo`
   - `namely` instead of `viz.`
   - `avoid` instead of `try not to`
+  - `such as` instead of `like`
+  - `after` instead of `once`
+  - `setup` as a noun, `set up` as a verb
 
 - Avoid condescending language:
   - Do not use `simply`, `just`, `obviously`, or `clearly`
 
+- Avoid using directions when referring to content that's been referenced previously or will be referenced next:
+ - Do not use `above`, `below`, `left`, `right`, `top`, or `bottom`
+
 - Acknowledge difficulty naturally:
   - Use phrases like `this step can be confusing at first`
 

.github/install-guide-review.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 | [ ] |