Merge pull request #131917 from v-lakast/iot-edge-content-standards-report

Changes based on Content Standards report

Author: v-dihans

articles/iot-edge/TOC.yml

@@ -1,4 +1,4 @@
-- name: Azure IoT Edge Documentation
+- name: Azure IoT Edge documentation
   href: index.yml
 - name: Overview
   items:

articles/iot-edge/quickstart-linux.md

@@ -16,12 +16,11 @@ ms.custom: mvc
 Test out Azure IoT Edge in this quickstart by deploying containerized code to a virtual Linux IoT Edge device. IoT Edge allows you to remotely manage code on your devices so that you can send more of your workloads to the edge. For this quickstart, we recommend using an Azure virtual machine for your IoT Edge device, which allows you to quickly create a test machine with the IoT Edge service installed and then delete it when you're finished.
 
 In this quickstart you learn how to:
-> [!div class="checklist"]
->
-> * Create an IoT Hub.
-> * Register an IoT Edge device to your IoT hub.
-> * Install and start the IoT Edge runtime on your virtual device.
-> * Remotely deploy a module to an IoT Edge device.
+
+* Create an IoT Hub.
+* Register an IoT Edge device to your IoT hub.
+* Install and start the IoT Edge runtime on your virtual device.
+* Remotely deploy a module to an IoT Edge device.
 
 ![Diagram - Quickstart architecture for device and cloud](./media/quickstart-linux/install-edge-full.png)
 

articles/iot-edge/quickstart.md

@@ -18,12 +18,10 @@ Try out Azure IoT Edge in this quickstart by deploying containerized code to a v
 
 In this quickstart you learn how to:
 
-> [!div class="checklist"]
->
-> * Create an IoT hub.
-> * Register an IoT Edge device to your IoT hub.
-> * Install and start the IoT Edge runtime on your virtual device.
-> * Remotely deploy a module to an IoT Edge device and send telemetry to IoT Hub.
+* Create an IoT hub.
+* Register an IoT Edge device to your IoT hub.
+* Install and start the IoT Edge runtime on your virtual device.
+* Remotely deploy a module to an IoT Edge device and send telemetry to IoT Hub.
 
 ![Diagram - Quickstart architecture for device and cloud](./media/quickstart/install-edge-full.png)
 

articles/iot-edge/tutorial-c-module-windows.md

@@ -395,7 +395,7 @@ Otherwise, you can delete the local configurations and the Azure resources that
 
 ## Next steps
 
-In this tutorial, you created an IoT Edge module with code to filter raw data that's generated by your IoT Edge device. When you're ready to build your own modules, you can learn more about [developing your own IoT Edge modules](module-development.md) or how to [develop modules with Visual Studio](how-to-visual-studio-develop-module.md). For examples of IoT Edge modules, including the simulated temperature module, see [IoT Edge module samples](https://github.com/Azure/iotedge/tree/master/edge-modules) and [IoT C SDK samples](https://github.com/Azure/azure-iot-sdk-c/tree/master/iothub_client/samples).
+In this tutorial, you created an IoT Edge module with code to filter raw data that's generated by your IoT Edge device.
 
 You can continue on to the next tutorials to learn how Azure IoT Edge can help you deploy Azure cloud services to process and analyze data at the edge.
 

articles/iot-edge/tutorial-c-module.md

@@ -362,7 +362,7 @@ Otherwise, you can delete the local configurations and the Azure resources that
 
 ## Next steps
 
-In this tutorial, you created an IoT Edge module that contains code to filter raw data generated by your IoT Edge device. When you're ready to build your own modules, you can learn more about [developing your own IoT Edge modules](module-development.md) or how to [develop modules with Visual Studio Code](how-to-vs-code-develop-module.md). For examples of IoT Edge modules, including the simulated temperature module, see [IoT Edge module samples](https://github.com/Azure/iotedge/tree/master/edge-modules) and [IoT C SDK samples](https://github.com/Azure/azure-iot-sdk-c/tree/master/iothub_client/samples).
+In this tutorial, you created an IoT Edge module that contains code to filter raw data generated by your IoT Edge device.
 
 You can continue on to the next tutorials to learn how Azure IoT Edge can help you deploy Azure cloud services to process and analyze data at the edge.
 

articles/iot-edge/tutorial-csharp-module-windows.md

@@ -360,7 +360,7 @@ Otherwise, you can delete the local configurations and the Azure resources that
 
 ## Next steps
 
-In this tutorial, you created an IoT Edge module with code to filter raw data that's generated by your IoT Edge device. When you're ready to build your own modules, you can learn more about [developing your own IoT Edge modules](module-development.md) or how to [develop modules with Visual Studio](how-to-visual-studio-develop-module.md). For examples of IoT Edge modules, including the simulated temperature module, see [IoT Edge module samples](https://github.com/Azure/iotedge/tree/master/edge-modules).
+In this tutorial, you created an IoT Edge module with code to filter raw data that's generated by your IoT Edge device.
 
 You can continue on to the next tutorials to learn how Azure IoT Edge can help you deploy Azure cloud services to process and analyze data at the edge.
 

articles/iot-edge/tutorial-csharp-module.md

@@ -335,7 +335,7 @@ Otherwise, you can delete the local configurations and the Azure resources that
 
 ## Next steps
 
-In this tutorial, you created an IoT Edge module that contains code to filter raw data generated by your IoT Edge device. When you're ready to build your own modules, you can learn more about [developing your own IoT Edge modules](module-development.md) or how to [develop modules with Visual Studio Code](how-to-vs-code-develop-module.md). For examples of IoT Edge modules, including the simulated temperature module, see [IoT Edge module samples](https://github.com/Azure/iotedge/tree/master/edge-modules).
+In this tutorial, you created an IoT Edge module that contains code to filter raw data generated by your IoT Edge device.
 
 You can continue on to the next tutorials to learn how Azure IoT Edge can help you deploy Azure cloud services to process and analyze data at the edge.
 

articles/iot-edge/tutorial-java-module.md

@@ -299,7 +299,7 @@ Otherwise, you can delete the local configurations and the Azure resources that
 
 ## Next steps
 
-In this tutorial, you created an IoT Edge module that filters raw data generated by your IoT Edge device. When you're ready to build your own modules, you can learn more about [developing IoT Edge modules](module-development.md) or how to [develop modules with Visual Studio Code](how-to-vs-code-develop-module.md). See [IoT Edge module samples](https://github.com/Azure/iotedge/tree/master/edge-modules) for code examples, including the simulated temperature module.
+In this tutorial, you created an IoT Edge module that filters raw data generated by your IoT Edge device.
 
 Continue to the next tutorials to learn how Azure IoT Edge helps you deploy Azure cloud services to process and analyze data at the edge.
 

articles/iot-edge/tutorial-machine-learning-edge-03-generate-data.md

@@ -1,6 +1,6 @@
 ---
 title: 'Tutorial: Generate simulated device data - Machine Learning on Azure IoT Edge'
-description: 'Create virtual devices that generate simulated telemetry that can later be used to train a machine learning model.'
+description: 'Tutorial - Create virtual devices that generate simulated telemetry that can later be used to train a machine learning model.'
 author: kgremban
 manager: philmea
 ms.author: kgremban

articles/iot-edge/tutorial-machine-learning-edge-05-configure-edge-device.md

@@ -288,13 +288,10 @@ Next we will update the certificates and hostname by directly editing the config
     ```bash
     journalctl -u iotedge --no-pager --no-full
     ```
-
 ## Next steps
 
 We just completed configuring an Azure VM as Azure IoT Edge Transparent Gateway. We started by generating test certificates that we uploaded to Azure Key Vault. Next, we used a script and Resource Manager template to deploy the VM with the "Ubuntu Server 16.04 LTS + Azure IoT Edge runtime" image from the Azure Marketplace. With the VM up and running we connected via SSH, we signed into Azure and downloaded certificates from Key Vault. We made several updates to the configuration of the IoT Edge Runtime by updating the config.yaml file.
 
-For more information see [How an IoT Edge device can be used as a gateway](iot-edge-as-gateway.md) and [Configure an IoT Edge device to act as a transparent gateway](how-to-create-transparent-gateway.md).
-
 Continue to the next article to build IoT Edge modules.
 
 > [!div class="nextstepaction"]

articles/iot-edge/tutorial-machine-learning-edge-06-custom-modules.md

@@ -807,15 +807,7 @@ In this article, we created an IoT Edge Solution in Visual Studio Code with thre
 
 Next, we updated the configuration of the IoT Hub to route our messages based on type and to handle file uploads. With everything in place, we deployed the modules to the IoT Edge device and ensured the modules were running correctly.
 
-See the following articles for more guidance:
-
-* [Learn how to deploy modules and establish routes in IoT Edge](module-composition.md)
-* [IoT Hub message routing query syntax](../iot-hub/iot-hub-devguide-routing-query-syntax.md)
-* [IoT Hub message routing: now with routing on message body](https://azure.microsoft.com/blog/iot-hub-message-routing-now-with-routing-on-message-body/)
-* [Upload files with IoT Hub](../iot-hub/iot-hub-devguide-file-upload.md)
-* [Upload files from your device to the cloud with IoT Hub](../iot-hub/iot-hub-python-python-file-upload.md)
-
 Continue to the next article to start sending data and see your solution in action.
 
 > [!div class="nextstepaction"]
-> [Send data via transparent gateway](tutorial-machine-learning-edge-07-send-data-to-hub.md)
+> [Send data via transparent gateway](tutorial-machine-learning-edge-07-send-data-to-hub.md)

articles/iot-edge/tutorial-machine-learning-edge-07-send-data-to-hub.md

@@ -233,5 +233,8 @@ In this article, we used our development VM to simulate a leaf device sending se
 
 More information can be found at the following pages:
 
-* [Connect a downstream device to an Azure IoT Edge gateway](how-to-connect-downstream-device.md)
-* [Store data at the edge with Azure Blob Storage on IoT Edge (preview)](how-to-store-data-blob.md)
+> [!div class="nextstepaction"]
+> [Connect a downstream device to an Azure IoT Edge gateway](how-to-connect-downstream-device.md)
+
+> [!div class="nextstepaction"]
+> [Store data at the edge with Azure Blob Storage on IoT Edge (preview)](how-to-store-data-blob.md)

articles/iot-edge/tutorial-node-module.md

@@ -252,7 +252,7 @@ Otherwise, you can delete the local configurations and the Azure resources that
 
 ## Next steps
 
-In this tutorial, you created an IoT Edge module that contains code to filter raw data generated by your IoT Edge device. When you're ready to build your own modules, you can learn more about [developing your own IoT Edge modules](module-development.md) or how to [develop modules with Visual Studio Code](how-to-vs-code-develop-module.md). For examples of IoT Edge modules, including the simulated temperature module, see [IoT Edge module samples](https://github.com/Azure/iotedge/tree/master/edge-modules).
+In this tutorial, you created an IoT Edge module that contains code to filter raw data generated by your IoT Edge device.
 
 You can continue on to the next tutorials to learn how Azure IoT Edge can help you deploy Azure cloud services to process and analyze data at the edge.
 

articles/iot-edge/tutorial-python-module.md

@@ -1,6 +1,6 @@
 ---
 # Mandatory fields. See more on aka.ms/skyeye/meta.
-title: Create custom Python module - Azure IoT Edge | Microsoft Docs 
+title: Tutorial - Create custom Python module - Azure IoT Edge | Microsoft Docs 
 description: This tutorial shows you how to create an IoT Edge module with Python code and deploy it to an edge device.
 services: iot-edge
 author: kgremban
@@ -265,12 +265,12 @@ Otherwise, you can delete the local configurations and the Azure resources that
 
 ## Next steps
 
-In this tutorial, you created an IoT Edge module that contains code to filter raw data generated by your IoT Edge device. When you're ready to build your own modules, you can learn more about [developing your own IoT Edge modules](module-development.md) or how to [develop modules with Visual Studio Code](how-to-vs-code-develop-module.md). For examples of IoT Edge modules, including the simulated temperature module, see [IoT Edge module samples](https://github.com/Azure/iotedge/tree/master/edge-modules) and [IoT Python SDK samples](https://github.com/Azure/azure-iot-sdk-python/tree/master/azure-iot-device/samples/async-edge-scenarios).
+In this tutorial, you created an IoT Edge module that contains code to filter raw data generated by your IoT Edge device.
 
 You can continue on to the next tutorials to learn how Azure IoT Edge can help you deploy Azure cloud services to process and analyze data at the edge.
 
 > [!div class="nextstepaction"]
 > [Functions](tutorial-deploy-function.md)
 > [Stream Analytics](tutorial-deploy-stream-analytics.md)
 > [Machine Learning](tutorial-deploy-machine-learning.md)
-> [Custom Vision Service](tutorial-deploy-custom-vision.md)
+> [Custom Vision Service](tutorial-deploy-custom-vision.md)

articles/iot-edge/tutorial-store-data-sql-server.md

@@ -327,10 +327,10 @@ Otherwise, you can delete the local configurations and the Azure resources that
 
 [!INCLUDE [iot-edge-clean-up-cloud-resources](../../includes/iot-edge-clean-up-cloud-resources.md)]
 
-## Next steps
-
 In this tutorial, you created an Azure Functions module that contains code to filter raw data generated by your IoT Edge device. When you're ready to build your own modules, you can learn more about how to [Develop Azure Functions with Azure IoT Edge for Visual Studio Code](how-to-develop-csharp-function.md).
 
+## Next steps
+
 If you want to try another storage method at the edge, read about how to use Azure Blob Storage on IoT Edge.
 
 > [!div class="nextstepaction"]