Refactor Zephyr Workbench documentation for clarity and consistency across installation, development, and debugging sections.

Author: madeline-underwood

content/learning-paths/embedded-and-microcontrollers/zephyr_vsworkbench/1_installation.md

@@ -1,58 +1,55 @@
 ---
-title: Prepare your system for Zephyr development in Visual Studio Code
+title: Set up your environment 
 weight: 2
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall
 ---
 
-## Set up your environment
+## The benefits of using Workbench for Zephyr Visual Code extension
 
-Setting up a [Zephyr](https://zephyrproject.org/) RTOS development environment from scratch can be challenging, requiring you to manually install SDKs, configure toolchains, and initialize workspace directories. These steps often vary across operating systems and board vendors, leading to a fragmented and error-prone setup process.
+Getting started with [Zephyr](https://zephyrproject.org/) RTOS development can be challenging. You often need to install SDKs, set up toolchains, and organize workspace directories by hand. The process is different for each operating system and board vendor, which can make setup confusing and lead to errors.
 
 [Workbench for Zephyr](https://zephyr-workbench.com/) is an open-source [Visual Studio Code extension](https://marketplace.visualstudio.com/items?itemName=Ac6.zephyr-workbench) that transforms Zephyr RTOS development into a streamlined IDE experience. Created by [Ac6](https://www.ac6.fr/en/), it automates toolchain setup, project management, and debugging, making Zephyr projects faster to start and easier to scale.
 
-In this Learning Path, you'll follow clear steps to install Workbench for Zephyr and set up a full development environment on your computer. By the end, you'll be able to create, build, and debug applications for Arm Cortex-M boards using Zephyr RTOS.
+In this Learning Path, you'll set up Workbench for Zephyr and configure a complete development environment on your computer. By the end, you can create, build, and debug applications for Arm Cortex-M boards using Zephyr RTOS.
 
-Workbench for Zephyr makes it easy to set up your development environment with a single click. It automatically installs all the tools you need, such as Python, CMake, Ninja, and Git. You can import and manage different versions of the Zephyr SDK, choose the right architecture, and quickly initialize west workspaces. The extension lets you create board-specific applications from sample projects, build and flash them to your hardware, and debug your code, all within Visual Studio Code. You also get features like breakpoint debugging and memory usage insights when using a supported hardware probe.
+Workbench for Zephyr makes it easy to set up your development environment with a single click. It automatically installs all the tools you need, such as Python, CMake, Ninja, and Git. You can import and manage different versions of the Zephyr SDK, choose the right architecture, and quickly initialize West workspaces. The extension lets you create board-specific applications from sample projects, build and flash them to your hardware, and debug your code, all within Visual Studio Code. You also get features like breakpoint debugging and memory usage insights when using a supported hardware probe.
 
 ## Install dependencies 
 
-To get started with Workbench for Zephyr, you need to have Visual Studio Code downloaded, installed, and running on your computer.
+To get started with Workbench for Zephyr, you need to have Visual Studio Code downloaded, installed, and running on your computer:
 
-**Windows OS:**
+
+### Windows
 For Windows, you need version 10 or later (64-bit x64), along with administrator privileges for installing runners and drivers. 
 
-**macOS:**
+### macOS
 On macOS, the Homebrew package manager is required. To install Homebrew, run the following command:
 
 ```bash
 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 ```
 
-**Linux:**
-- A recent 64-bit X64 distribution such as Ubuntu 20.04 or later, Fedora, Clear Linux OS, or Arch Linux
-- Other distributions might work, but might require manual configuration of system packages
-- After installation, use the Workbench host tools manager to verify that all required tools were installed correctly
+### Linux
+To use Workbench for Zephyr on Linux, install a recent 64-bit distribution such as Ubuntu 20.04 or later, Fedora, Clear Linux OS, or Arch Linux. Other distributions can work, but you might need to manually configure some system packages. After installing your operating system, use the Workbench host tools manager to check that all required tools are installed correctly.
 
 
 Zephyr Workbench supports STM32 development boards (STM32 Discovery, Nucleo series), Nordic Semiconductor boards (nRF52, nRF53, nRF91 series), NXP development boards (FRDM, LPCXpresso series), Espressif boards (ESP32-based boards), and many other Zephyr-supported platforms like Renesas, Silabs or Infineon. You need a development board to try out the code examples.
 
-## Configure the Workbench for Zephyr extension in Visual Studio Code
-
-This section covers installing the Zephyr Workbench extension and configuring your Arm development environment.
+## Install and configure the Zephyr Workbench extension
 
-### Install the Workbench for Zephyr extension
+This section covers installing the Workbench for Zephyr extension and configuring your Arm development environment.
 
-To install the Workbench for Zephyr extension, open Visual Studio Code. In the Activity Bar, select the **Extensions** icon to open the Extensions view.
+To install the Workbench for Zephyr extension, open **Visual Studio Code**. In the **Activity Bar**, select the **Extensions** icon to open the **Extensions view**.
 
-You can also use the keyboard shortcut `Ctrl+Shift+X` on Windows or Linux, or `Cmd+Shift+X` on macOS.
+You can also use the keyboard shortcut **Ctrl+Shift+X** on Windows or Linux, or **Cmd+Shift+X** on macOS.
 
-In the search box, enter **Workbench for Zephyr**. Locate the official extension by Ac6 and select **Install**.
+In the search box, enter `Workbench for Zephyr`. Locate the official extension by **Ac6** and select **Install**.
 
-After installation, the Workbench for Zephyr icon appears in the Activity Bar. A welcome screen confirms that the extension is ready to use.
+After installation, the Workbench for Zephyr icon appears in the **Activity Bar**. A welcome screen confirms that the extension is ready to use.
 
-### Install the required host tools
+## Install the required host tools
 
 In the Workbench for Zephyr panel, select **Install Host Tools** to automatically install the required dependencies. 
 
@@ -64,16 +61,20 @@ This process installs Python 3.x, CMake, the Ninja build system, Git, Device Tre
 On Windows, you might see permission prompts when Workbench for Zephyr installs or runs tools. Select **Allow** to continue with the setup.{{% /notice%}}
 
 When the installation completes, select **Verify Host Tools** to confirm that each required package is installed and up to date. The panel displays the version and status for Python, CMake, Ninja, Git, and Device Tree Compiler. If any tool is missing or out of date, follow the prompts to resolve the issue before continuing.
-### Import and configure the Zephyr toolchain
+## Import and configure the Zephyr toolchain
 
 To build and debug Zephyr applications for Arm Cortex-M boards, you need to import and configure the Zephyr toolchain using Workbench for Zephyr.
 
 In the Workbench for Zephyr panel, select **Import Toolchain**. This opens a guided setup panel.
 
-- For **Toolchain Family**, select *Zephyr SDK*
-- For **SDK Type**, choose *Minimal* to install only the essential components
-- For **Version**, pick the Zephyr SDK release you want to use, such as v0.17.0 or v0.17.3
-- For **Target Architectures**, select *arm* to target Arm-based boards
+In the **Import Toolchain** panel, configure the following options to set up your Zephyr toolchain for Arm development:
+
+- **Toolchain Family**: select *Zephyr SDK* to use the official Zephyr toolchain.
+- **SDK Type**: select *Minimal* to install only the essential components needed for development.
+- **Version**: select the Zephyr SDK release you want to use, such as v0.17.0 or v0.17.3.
+- **Target Architectures**: select *arm* to target Arm-based boards.
+
+These settings ensure your environment is optimized for Arm Cortex-M development. After configuring these options, continue with the import process to download and install the selected SDK.
 
 Next, specify the directory where you want to install the SDK. Select **Import** to start the download and installation process. When the import completes, the panel displays a confirmation that the toolchain is ready.
 
@@ -83,7 +84,7 @@ If you see errors during import, check your internet connection and confirm you
 ![Workbench for Zephyr Import Toolchain panel in Visual Studio Code. The panel displays options for selecting the toolchain family, SDK type, version, and target architectures. Visible text includes Import Toolchain, Zephyr SDK, Minimal, v0.17.0, v0.17.3, and arm. The interface is organized and user-friendly, with clearly labeled dropdown menus and buttons. The overall tone is instructional and welcoming, set within a modern code editor workspace. alt-text #center](images/import_toolchain.png "Workbench for Zephyr Import Toolchain panel")
 
 
-### Initialize the Zephyr project workspace
+## Initialize the Zephyr project workspace
 
 Zephyr uses a Git-based workspace manager called West to organize its source code, modules, and samples. Use Workbench for Zephyr to initialize your first West workspace.
 
@@ -99,7 +100,7 @@ Select **Import** to create and update the workspace.
 The workspace initialization downloads the Zephyr source code and dependencies. This process can take several minutes depending on your internet connection speed.
 {{% /notice %}}
 
-### Verify setup
+## Verify setup
 
 Test your setup by confirming that the Workbench for Zephyr panel shows all components as installed successfully. Verify the host tools are installed, the SDK is imported and detected, and the West workspace is initialized. Ensure no error messages appear in the VS Code output panel.
 {{% notice Troubleshooting Tips %}} If you have trouble installing host tools on Windows, try running Visual Studio Code as an administrator. Make sure your firewall allows internet access so dependencies can download. Before importing the SDK, confirm you have at least 2 GB of free disk space.{{% /notice %}}

content/learning-paths/embedded-and-microcontrollers/zephyr_vsworkbench/2_development.md

@@ -1,21 +1,21 @@
 ---
-title: Build Zephyr applications in VS Code
+title: Build a Zephyr application with Zephyr workbench
 weight: 3
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall
 ---
 
-## Create and build your first Zephyr application
+## Set up your Zephyr development board and environment
 
-In this session, you'll learn how to create and build your first Zephyr application using Workbench for Zephyr. This step prepares you to customize, test, and expand real firmware projects on Arm Cortex-M boards.
+In this section, you'll learn how to create and build your first Zephyr application using Workbench for Zephyr. This step prepares you to customize, test, and expand real firmware projects on Arm Cortex-M boards.
+For this demonstration, you'll use an [NXP FRDM-MCXN947](https://www.nxp.com/design/design-center/development-boards-and-designs/FRDM-MCXN947) development board as your target device. The same process works for any Zephyr-supported Arm Cortex-M board. 
 
-For demonstration, you'll use an [NXP FRDM-MCXN947](https://www.nxp.com/design/design-center/development-boards-and-designs/FRDM-MCXN947) development board as the target device. However, the same steps apply to any Zephyr-supported Arm Cortex-M board. 
-You can find the full list of supported boards in the [Supported Boards](https://docs.zephyrproject.org/latest/boards/#).
+To see all compatible boards, visit the [Zephyr Supported Boards list](https://docs.zephyrproject.org/latest/boards/#).
 
 Depending on your board, you might need to install a different debug tool aka `runner`. The next section covers this setup.
 
-### Create application
+## Create the application
 
 In the Zephyr Workbench panel:
 
@@ -29,17 +29,17 @@ Configure your project:
 
 After you complete these steps, Workbench for Zephyr creates the project and prepares it for building.
 
-![Zephyr Workbench Create New Application panel in VS Code showing workspace selection SDK version target board dropdown sample application selection and project name fields. The interface is clean and organized with clear labels and buttons. The wider VS Code environment is visible in the background with a neutral and professional tone. All text in the panel is legible and guides the user through creating a new Zephyr application.](images/create_app.png "Zephyr Workbench Create New Application panel")
+![Zephyr Workbench Create New Application panel in VS Code showing workspace selection SDK version target board dropdown sample application selection and project name fields. The interface is clean and organized with clear labels and buttons. The wider VS Code environment is visible in the background with a neutral and professional tone. All text in the panel is legible and guides the user through creating a new Zephyr application. alt-text #center](images/create_app.png "Zephyr Workbench Create New Application panel")
 
-### Build the application
+## Build the application
 
 Select the **Build** button in Workbench for Zephyr or press `Ctrl+Shift+B`.
 
 The build system compiles your application and links it against the Zephyr kernel and board-specific drivers.
 
 ![VS Code Zephyr Workbench build application panel showing workspace selection, SDK version, target board dropdown, sample application selection, and project name fields. The primary subject is the Zephyr Workbench interface guiding users through building a Zephyr application. Visible text includes labels such as Workspace, SDK, Target Board, Sample Application, and Project Name, with buttons for Create New Application and Build. The wider VS Code environment is visible in the background, presenting a clean and organized workspace with a neutral, professional tone. alt-text#center]
 
-### Install board-specific debug utilities
+## Install board-specific debug utilities
 
 To enable debugging on your target hardware, you might need to install additional tools based on the board vendor.
 
@@ -54,7 +54,7 @@ If Workbench for Zephyr doesn't automatically detect the installed debug runner,
 Open the **Debug Manager** from the Zephyr sidebar, and enter the full path to the runner executable.
 {{% /notice %}}
 
-### Review output
+## Review the output
 
 Check the build output at the bottom panel of VS Code. Make sure there are no errors or warnings. A successful build displays:
 
@@ -65,7 +65,7 @@ Memory region         Used Size  Region Size  % Used
             SRAM:       4048 B       256 KB      1.5%
 ```
 
-### Code walkthrough: hello_world
+## Code walkthrough: hello_world
 
 The following code shows a basic Zephyr application that prints a message to the console: