Merge pull request #3384 from pareenaverma/content_review

pareenaverma · web-flow · commit 9f23ce8278d2 · 2026-06-10T14:59:32.000-04:00
Topo template tech review
diff --git a/content/learning-paths/cross-platform/create-your-own-topo-templates/_index.md b/content/learning-paths/cross-platform/create-your-own-topo-templates/_index.md
@@ -16,10 +16,10 @@ learning_objectives:
     - Clone and deploy an existing Topo Template and modify it by adding new clone-time arguments
     - Create a new Topo Template from a Docker Compose project
     - Add x-topo metadata for configurable arguments, deployment guidance, and hardware requirements
-    - Understand where to find Agent Skills, for use when creating or modifying Topo Templates
+    - Locate and install Agent Skills to assist with creating and reviewing Topo Templates
 
 prerequisites:
-    - This learning path builds on [Deploy containerized workloads to Arm-based Linux targets with Topo](/learning-paths/cross-platform/deploy-containerized-workloads-with-topo/).
+    - This Learning Path builds on [Deploy containerized workloads to Arm-based Linux targets with Topo](/learning-paths/cross-platform/deploy-containerized-workloads-with-topo/).
     - A host machine (x86 or Arm) with Linux, macOS, or Windows
     - An Arm-based Linux target accessible over SSH, for example an Arm-based Linux VM, Raspberry Pi, DGX Spark, or NXP i.MX 93
     - Docker installed on the host and target. For installation steps, see [Install Docker](/install-guides/docker/).
diff --git a/content/learning-paths/cross-platform/create-your-own-topo-templates/agent-skills.md b/content/learning-paths/cross-platform/create-your-own-topo-templates/agent-skills.md
@@ -14,7 +14,7 @@ These skills are optional authoring aids. The Template you created in this Learn
 
 Visit [Topo Skills](https://github.com/arm/topo-template-format#authoring-skills) for the most up-to-date list of the available Topo Template skills and instructions on how to install them.
 
-At the time of writing, the [Topo Template Format Specification](https://github.com/arm/topo-template-format) provides the following skills:
+The [Topo Template Format Specification](https://github.com/arm/topo-template-format) currently provides the following skills:
 
 1. `topo-template-context`: provides Topo and Topo Template reference context for questions about x-topo metadata, schema, docs, and CLI Template behavior.
 2. `topo-template-bootstrap`: converts a repository into a Topo Template by adding or improving `compose.yaml` and `x-topo` metadata.
@@ -24,6 +24,10 @@ At the time of writing, the [Topo Template Format Specification](https://github.
 
 Install the Topo Template skills with [npx skills](https://github.com/vercel-labs/skills):
 
+{{% notice Note %}}
+`npx` requires Node.js. If Node.js is not installed on your machine, install it before running the command below.
+{{% /notice %}}
+
 ```bash
 npx skills add arm/topo-template-format --all --yes
 ```
@@ -37,3 +41,9 @@ You can then prompt your agent to use the skill to create a Topo Template from a
 ```text
 Use the topo-template-bootstrap skill to convert this repository into a Topo Template.
 ```
+
+## What you've accomplished and what's next
+
+You have now completed this Learning Path. You can create, modify, and deploy Topo Templates to Arm-based Linux targets, and use Agent Skills to assist with the authoring process.
+
+Explore the [Topo Catalog](https://github.com/arm/topo/blob/main/internal/catalog/data/catalog.json) to find more Templates to clone and modify, or share your own Template with the community.
diff --git a/content/learning-paths/cross-platform/create-your-own-topo-templates/creating-a-new-template.md b/content/learning-paths/cross-platform/create-your-own-topo-templates/creating-a-new-template.md
@@ -40,7 +40,13 @@ topo-message-card/
 
 ### Create the web page
 
-Create the application HTML file:
+Create the `src/` subdirectory and `src/index.html`:
+
+```bash
+mkdir -p src
+```
+
+Open `src/index.html` in a text editor and add the following content:
 
 ```html
 <!doctype html>
@@ -93,7 +99,7 @@ The values wrapped in double underscores are placeholders. The `Dockerfile` repl
 
 ### Create the Dockerfile
 
-Create a `Dockerfile`:
+Create a file named `Dockerfile` in the `topo-message-card` directory with the following content:
 
 ```Dockerfile
 FROM nginx:alpine
@@ -115,7 +121,7 @@ Topo passes configuration values to Templates through Docker build arguments. Th
 
 ### Create the compose file
 
-Create `compose.yaml`:
+Create `compose.yaml` in the `topo-message-card` directory with the following content:
 
 ```yaml
 # yaml-language-server: $schema=https://raw.githubusercontent.com/arm/topo-template-format/refs/heads/main/schema/topo-template-format.json
@@ -193,7 +199,7 @@ After cloning, inspect the generated project:
 
 ```bash
 cd ~/message-card-demo
-sed -n '1,80p' compose.yaml
+cat compose.yaml
 ```
 
 The `build.args` should contain the values you provided:
diff --git a/content/learning-paths/cross-platform/create-your-own-topo-templates/hello-world-template.md b/content/learning-paths/cross-platform/create-your-own-topo-templates/hello-world-template.md
@@ -6,7 +6,7 @@ weight: 3
 layout: learningpathall
 ---
 
-This section quickly runs through the deployment of the `Hello World` Template, similar to the `CPU LLM Chat` Template in the [Deploy containerized workloads to Arm-based Linux targets with Topo](/learning-paths/cross-platform/deploy-containerized-workloads-with-topo/) Learning Path.
+Deploy the `Hello World` Template to confirm your setup before modifying it in the next section. This Template follows the same deployment pattern as the `CPU LLM Chat` Template covered in [Deploy containerized workloads to Arm-based Linux targets with Topo](/learning-paths/cross-platform/deploy-containerized-workloads-with-topo/).
 
 ## Clone the 'Hello World' Topo Template
 
@@ -34,7 +34,7 @@ Default: World
 GREETING_NAME (required)>
 ```
 
-Provide a name for the `GREETING_NAME` argument, e.g., 'Tomas'. 
+Provide a name for the `GREETING_NAME` argument, for example, 'Tomas'.
 
 Press Enter to submit your entry. You will then see a similar output to below:
 
@@ -131,5 +131,10 @@ Then open `http://localhost:8000/` in your browser.
 
 The Hello World application appears as follows:
 
-
 ![Screenshot of the Hello World web interface. This confirms successful deployment and provides a visual reference for the expected result.#center](hello_tomas.png "Hello World web interface")
+
+## What you've accomplished and what's next
+
+You deployed the Hello World Template to an Arm-based Linux target and confirmed the application is accessible in your browser.
+
+Next, you will modify the Template to add a new configurable clone-time argument.
diff --git a/content/learning-paths/cross-platform/create-your-own-topo-templates/modifying-hello-world.md b/content/learning-paths/cross-platform/create-your-own-topo-templates/modifying-hello-world.md
@@ -144,10 +144,10 @@ Example: Markus
 Default: World
 GREETING_NAME (required)> 
 
-Provide: The emoji to use in the greeting message
+Provide: The emoji to show next to the greeting
 Example: 🚀
 Default: 🐳
-GREETING_EMOJI (required)> 🚀
+GREETING_EMOJI (optional)> 🚀
 ```
 
 ### Deploy the modified Template
@@ -169,5 +169,10 @@ Then open `http://localhost:8000/` in your browser.
 
 The Hello World application appears as follows:
 
-
 ![Screenshot of the modified Hello World web interface. This confirms successful modification and deployment and provides a visual reference for the expected result.#center](modified_template.png "Hello World web interface - with new emoji argument")
+
+## What you've accomplished and what's next
+
+You modified the Hello World Template to add a new optional clone-time argument, updated the Dockerfile to consume it, and deployed the result to your Arm-based Linux target.
+
+Next, you will create a new Topo Template from scratch.
diff --git a/content/learning-paths/cross-platform/create-your-own-topo-templates/overview.md b/content/learning-paths/cross-platform/create-your-own-topo-templates/overview.md
@@ -12,7 +12,7 @@ layout: learningpathall
 
 Before getting started, you should complete the Learning Path [Deploy containerized workloads to Arm-based Linux targets with Topo](/learning-paths/cross-platform/deploy-containerized-workloads-with-topo/) to learn about Topo, why to use it, how to install it and how to use it for target inspection, listing Templates and deployment.
 
-We now assume that you have Topo installed on your host machine and that you have an Arm-based Linux target available over SSH. Use the same target pattern from the previous Learning Path, for example a Raspberry Pi, an AWS Arm instance, or another Arm-based Linux system:
+At this point, you should have Topo installed on your host machine and an Arm-based Linux target available over SSH. Use the same target pattern from the previous Learning Path, for example a Raspberry Pi, an AWS Arm instance, or another Arm-based Linux system:
 
 ```bash
 --target user@my-target
