Freshness review

Author: PatAltimore

learn-pr/student-evangelism/deploy-prebuilt-module-edge-device/1-introduction.yml

@@ -1,15 +1,15 @@
-### YamlMime:ModuleUnit
-uid: learn.oxford.deploy-prebuilt-module-edge-device.1-introduction
-title: Introduction
-metadata:
-  title: Introduction
-  description: In this unit, we help the learner to decide if the product will meet their needs by explaining when to use the product and how it works.
-  ms.date: 11/27/2023
-  author: PatAltimore
-  ms.author: leestott
-  ms.topic: unit
-  ms.custom: team=nextgen
-durationInMinutes: 3 # dummy number at present
-content: |
-  [!include[](includes/1-introduction.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.oxford.deploy-prebuilt-module-edge-device.1-introduction
+title: Introduction
+metadata:
+  title: Introduction
+  description: In this unit, we help the learner to decide if the product will meet their needs by explaining when to use the product and how it works.
+  ms.date: 05/09/2025
+  author: PatAltimore
+  ms.author: leestott
+  ms.topic: unit
+  ms.custom: team=nextgen
+durationInMinutes: 3
+content: |
+  [!include[](includes/1-introduction.md)]
+

learn-pr/student-evangelism/deploy-prebuilt-module-edge-device/2-what-is-prebuilt-module.yml

@@ -1,15 +1,15 @@
-### YamlMime:ModuleUnit
-uid: learn.oxford.deploy-prebuilt-module-edge-device.2-what-is-prebuilt-module
-title: Use a pre-built module to generate test data
-metadata:
-  title: Use a pre-built module to generate test data
-  description: In this unit, we provide a definition of a pre-built module
-  ms.date: 11/27/2023
-  author: PatAltimore
-  ms.author: leestott
-  ms.topic: unit
-  ms.custom: team=nextgen
-durationInMinutes: 4 # dummy number at present
-content: |
-  [!include[](includes/2-what-is-prebuilt-module.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.oxford.deploy-prebuilt-module-edge-device.2-what-is-prebuilt-module
+title: Use a pre-built module to generate test data
+metadata:
+  title: Use a pre-built module to generate test data
+  description: In this unit, we provide a definition of a pre-built module
+  ms.date: 05/09/2025
+  author: PatAltimore
+  ms.author: leestott
+  ms.topic: unit
+  ms.custom: team=nextgen
+durationInMinutes: 4
+content: |
+  [!include[](includes/2-what-is-prebuilt-module.md)]
+

learn-pr/student-evangelism/deploy-prebuilt-module-edge-device/3-how-setup-communication.yml

@@ -1,15 +1,15 @@
-### YamlMime:ModuleUnit
-uid: learn.oxford.deploy-prebuilt-module-edge-device.3-how-setup-communication
-title: Set up communication between IoT Hub and IoT Edge
-metadata:
-  title: Set up communication between IoT Hub and IoT Edge
-  description: In this unit, we provide the definition of resource group, how to create an IoT Edge device, an IoT Hub, and how to set up communication between IoT Edge and IoT Hub
-  ms.date: 11/27/2023
-  author: PatAltimore
-  ms.author: leestott
-  ms.topic: unit
-  ms.custom: team=nextgen
-durationInMinutes: 7 # dummy number at present
-content: |
-  [!include[](includes/3-how-setup-communication.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.oxford.deploy-prebuilt-module-edge-device.3-how-setup-communication
+title: Set up communication between IoT Hub and IoT Edge
+metadata:
+  title: Set up communication between IoT Hub and IoT Edge
+  description: In this unit, we provide the definition of resource group, how to create an IoT Edge device, an IoT Hub, and how to set up communication between IoT Edge and IoT Hub
+  ms.date: 05/09/2025
+  author: PatAltimore
+  ms.author: leestott
+  ms.topic: unit
+  ms.custom: team=nextgen
+durationInMinutes: 7
+content: |
+  [!include[](includes/3-how-setup-communication.md)]
+

learn-pr/student-evangelism/deploy-prebuilt-module-edge-device/includes/1-introduction.md

@@ -1,24 +1,24 @@
-In the development phase of an IoT project, the continuous streams of data typically generated by deployed IoT devices aren't easy to acquire. To simulate data, you can use a prebuilt module as an executable package and deploy this module as a container on an IoT Edge device.
+In the development phase of an IoT project, the continuous streams of data typically generated by deployed IoT devices aren't easy to acquire. Simulate data by using a prebuilt module as an executable package and deploying it as a container on an IoT Edge device.
 
-Suppose you're a developer who is deploying IoT applications for a factory automation application. You want to capture data about the machines running on the factory floor, such as the server room or the wind turbine. But you also want to capture data about the environment around the machines, like the ambient temperature. It isn't easy to acquire and visualize this data from the factory floor before the application goes live. Hence, you need a way to simulate data that mimics your scenarios to test your application.
+Suppose you're a developer deploying IoT applications for factory automation. You want to capture data about machines running on the factory floor, like the server room or wind turbine. But you also want to capture data about the environment around the machines, like the ambient temperature. It isn't easy to acquire and visualize this data from the factory floor before the application goes live. So, you need a way to simulate data that mimics your scenarios to test your application.
 
 ![An illustration showing the flow for deploying prebuilt module to the Edge device.](../media/deploy-prebuilt-module.png)
 
-We explore the following engineering-led themes:
+This article explores the following engineering-led themes:
 
 - Forecasting behavior of a component or system
 - Design of solutions
 - Anticipating constraints/tolerances and specific operating conditions
 - Safety and security considerations
 - Building tools that help to create the solution  
 
-In this module, you'll register an IoT Edge device to your IoT hub. You'll then start the IoT Edge runtime on your virtual device. Next, you'll remotely deploy a prebuilt module to an IoT Edge device that simulates sensors running on that device. Finally, you'll view the module's generated data to verify that the module is running on the device. We're using Azure IoT Edge on an Ubuntu virtual machine. In this case, your device already has the IoT Edge runtime installed. You're not running IoT Edge on your local machine or an ARM32 or ARM64 device.
+In this module, you register an IoT Edge device to your IoT hub. Then, you start the IoT Edge runtime on your virtual device. Next, you remotely deploy a prebuilt module to an IoT Edge device that simulates sensors running on that device. Finally, you view the module's generated data to verify that the module is running on the device. This article uses Azure IoT Edge on an Ubuntu virtual machine. In this case, your device already has the IoT Edge runtime installed. This setup doesn't run IoT Edge on a local machine or an ARM32 or ARM64 device.
 
 ## Learning objectives
 
-In this module, you'll:
+In this module, you:
 
-- Launch a module from Azure portal to IoT Edge  
+- Launch a module from Azure portal to IoT Edge
 - Generate simulated data from an edge device
 - Verify data generated from the edge device
 

learn-pr/student-evangelism/deploy-prebuilt-module-edge-device/includes/2-what-is-prebuilt-module.md

@@ -1,12 +1,12 @@
-The IoT Edge platform works with the cloud to deploy IoT Edge **modules** to your IoT Edge devices. 
+The IoT Edge platform works with the cloud to deploy IoT Edge **modules** to IoT Edge devices. 
 
 ## What is a module?
 
-IoT Edge modules are executable packages implemented as containers.
+IoT Edge modules are executable packages that run as containers.
 
-Through IoT Edge modules, you can deploy cloud workloads to run directly on IoT devices. IoT Edge modules are the smallest computation units managed by IoT Edge. Using IoT Edge modules, you can analyze data on devices instead of the cloud. By moving parts of your workload to the edge, your devices can spend less time sending messages to the cloud and react more quickly to events.
+IoT Edge modules let you deploy cloud workloads to run directly on IoT devices. IoT Edge modules are the smallest computational units managed by IoT Edge. IoT Edge modules let you analyze data on devices instead of in the cloud. Moving parts of your workload to the edge reduces the time devices spend sending messages to the cloud and helps them react more quickly to events.
 
-## What is a pre-built module?
+## What is a prebuilt module?
 
-Pre-built IoT Edge Modules are accessed through the Microsoft Artifact Registry or from third-party publisher container registries.
-The module you deploy simulates a sensor. It sends generated data back to the IoT Hub. You can use the simulated data for development and testing your IoT solution.
+Prebuilt IoT Edge modules are accessed through the Microsoft Artifact Registry or third-party publisher container registries.
+The module simulates a sensor and sends generated data to the IoT Hub. Use the simulated data to develop and test your IoT solution.

learn-pr/student-evangelism/deploy-prebuilt-module-edge-device/includes/3-how-setup-communication.md

@@ -1,47 +1,47 @@
-The steps below summarize the process of setting up and configuring IoT Edge, an IoT Hub, and the IoT device to deploy our module to it.
+The steps below summarize how to set up and configure IoT Edge, an IoT Hub, and an IoT device to deploy a module to it.
 
-1. Define the resource group or use an existing one.
+1. Define a resource group or use an existing one.
 1. Create an Azure IoT Edge device.
 1. Create an Azure IoT Hub or use an existing one.
 1. Register the IoT Edge device to the IoT Hub.
 
-Although you could execute the Azure IoT Edge runtime on your own physical Linux device, we deploy an Ubuntu-based virtual machine to Azure to act as the IoT Edge device.
+Although you can run the Azure IoT Edge runtime on a physical Linux device, this article uses an Ubuntu-based virtual machine in Azure as the IoT Edge device.
 
-As a consequence, you need an active Azure subscription to follow the exercises. Either create a free account that comes with a 30 days trial or use your pay-as-you-go subscription.
+You need an active Azure subscription to follow the exercises. Create a free account with a 30-day trial or use a pay-as-you-go subscription.
 
 ## What is a resource group?
 
-A resource group is a container to logically group Azure resources. These resources can be, for example, storage accounts, virtual networks, and virtual machines (VMs) you want to treat as a single entity. The resource group stores metadata about the resources. Therefore, when you specify a location for the resource group, you're selecting where that metadata is stored. For compliance reasons, you may need to keep your data in a particular region.
+A resource group is a container to logically group Azure resources. These resources can include storage accounts, virtual networks, and virtual machines (VMs) that you treat as a single entity. The resource group stores metadata about the resources. When you specify a location for the resource group, you select where that metadata is stored. For compliance reasons, you might need to keep your data in a particular region.
 
 ## Create an Azure IoT Edge device
 
-IoT Edge devices have the IoT Edge runtime installed on them. The Azure "IoT Edge on Ubuntu" virtual machine is an IoT device ready for use.
+IoT Edge devices have the IoT Edge runtime installed. The Azure "IoT Edge on Ubuntu" virtual machine is an IoT device that's ready for use.
 
-The **IoT Edge runtime** is a collection of programs that turn a device into an IoT Edge device. Collectively, the IoT Edge runtime components enable IoT Edge devices to receive code to run at the edge and communicate the results with an IoT Hub.
+The **IoT Edge runtime** is a collection of programs that turn a device into an IoT Edge device. These components let IoT Edge devices receive code to run at the edge and communicate results with an IoT Hub.
 
-* **IoT Edge module runtime:** starts each time an IoT Edge device boots and bootstraps the device by running the IoT Edge agent.
-* **IoT Edge agent:** facilitates deployment and monitoring of modules on the IoT Edge device, including the IoT Edge hub.
-* **IoT Edge hub:** manages communications between modules on the IoT Edge device and between the device and IoT Hub. 
+* **IoT Edge module runtime:** starts whenever an IoT Edge device boots and initializes the device by running the IoT Edge agent.
+* **IoT Edge agent:** manages deployment and monitoring of modules on the IoT Edge device, including the IoT Edge hub.
+* **IoT Edge hub:** handles communications between modules on the IoT Edge device and between the device and IoT Hub. 
 
 ## Create an IoT Hub
 
-Azure IoT Hub enables the communication between the virtual device and the cloud. To create a new Azure IoT Hub with the Azure CLI, you'll use the `az iot hub create` command set.
+Azure IoT Hub lets the virtual device communicate with the cloud. To create a new Azure IoT Hub with the Azure CLI, use the `az iot hub create` command set.
 
 > [!NOTE]
-> Only one **free** IoT hub instance is allowed in a subscription. The free level of IoT Hub works for this exercise. If you've used IoT Hub in the past and already have a free hub created, you can use that IoT hub.
+> Only one **free** IoT hub instance is allowed in a subscription. The free level of IoT Hub works for this exercise. If you've used IoT Hub in the past and already created a free hub, use that IoT hub.
 
-## Register the IoT Edge device to IoT Hub
+## Register the IoT Edge device with IoT Hub
 
-1. Use the `az iot hub device-identity create` command to create a device identity for your Edge device on Azure. The device identity enables you to communicate with your IoT Hub.
-1. Retrieve the connection string with the `az iot hub device-identity connection-string show` command. Every device identity uses a unique device connection string to associate it with a physical device.
-1. Set up the connection string on the IoT Edge device so it can connect to the IoT Hub. You can do this remotely without connection to the virtual machine by running a script on the device. Use the `az vm run-command` to invoke a script on the edge device and pass the connection string as a parameter.  
+1. Run the `az iot hub device-identity create` command to create a device identity for your Edge device on Azure. The device identity lets the device communicate with your IoT Hub.
+1. Run the `az iot hub device-identity connection-string show` command to retrieve the connection string. Each device identity uses a unique connection string to associate it with a physical device.
+1. Set up the connection string on the IoT Edge device so it can connect to the IoT Hub. Do this remotely without connecting to the virtual machine by running a script on the device. Run the `az vm run-command` command to invoke a script on the edge device and pass the connection string as a parameter.
 
-## Ensure the IoT Edge device is ready to run pre-built modules
+## Ensure the IoT Edge device is ready to run prebuilt modules
 
 Once the edge device is configured, check if it is ready to run a pre-built module.
 
-* Log on to the edge device using the public IP address for the device and run the `ssh command`.
-* With `iotedge` commands, you can check if the IoT Edge security daemon is running as a system service.
+* Sign in to the edge device using the public IP address for the device and run the `ssh command`.
+* Use `iotedge` commands to check if the IoT Edge security daemon is running as a system service.
 
 > [!NOTE]
-> You need elevated privileges to run `iotedge` commands.
+> Elevated privileges are required to run `iotedge` commands.