Merge pull request #112130 from dominicbetts/central-developer-next-steps

ttorble · web-flow · commit c5f1a746290b · 2020-04-21T15:50:11.000+01:00
Update next steps for device developers
diff --git a/articles/iot-central/core/concepts-get-connected.md b/articles/iot-central/core/concepts-get-connected.md
@@ -14,6 +14,8 @@ ms.custom:  [amqp, mqtt]
 
 # Get connected to Azure IoT Central
 
+*This article applies to operators and device developers.*
+
 This article describes the options for connecting your devices to an Azure IoT Central application.
 
 Typically, you must register a device in your application before it can connect. However, IoT Central does support scenarios where [devices can connect without first being registered](#connect-without-registering-devices).
@@ -262,7 +264,8 @@ All data exchanged between devices and your Azure IoT Central is encrypted. IoT
 
 ## Next steps
 
-Now that you've learned about device connectivity in Azure IoT Central, here are the suggested next steps:
+If you're a device developer, some suggested next steps are to:
 
-- [Prepare and connect a DevKit device](howto-connect-devkit.md)
-- [C SDK: Provisioning Device Client SDK](https://github.com/Azure/azure-iot-sdk-c/blob/master/provisioning_client/devdoc/using_provisioning_client.md)
+- Learn how to [Monitor device connectivity using Azure CLI](./howto-monitor-devices-azure-cli.md)
+- Learn how to [Define a new IoT device type in your Azure IoT Central application](./howto-set-up-template.md)
+- Read about [Azure IoT Edge devices and Azure IoT Central](./concepts-iot-edge.md)
diff --git a/articles/iot-central/core/concepts-iot-edge.md b/articles/iot-central/core/concepts-iot-edge.md
@@ -11,6 +11,8 @@ services: iot-central
 
 # Connect Azure IoT Edge devices to an Azure IoT Central application
 
+*This article applies to solution builders and device developers.*
+
 IoT Edge is made up of three components:
 
 * **IoT Edge modules** are containers that run Azure services, partner services, or your own code. Modules are deployed to IoT Edge devices, and run locally on those devices.
@@ -67,4 +69,4 @@ If you selected an IoT Edge device to be a gateway device, you can add downstrea
 
 ## Next steps
 
-Now that you know what IoT Central application templates are, get started by [creating an IoT Central Application](quick-deploy-iot-central.md).
+If you're a device developer, a suggested next step is to learn about [gateway device types in IoT Central](./tutorial-define-gateway-device-type.md).
diff --git a/articles/iot-central/core/howto-connect-devkit.md b/articles/iot-central/core/howto-connect-devkit.md
@@ -12,6 +12,8 @@ manager: jeffya
 
 # Connect an MXChip IoT DevKit device to your Azure IoT Central application
 
+*This article applies to device developers.*
+
 This article shows you how to connect an MXChip IoT DevKit (DevKit) device to an Azure IoT Central application. The device uses the certified IoT Plug and Play (preview) model for the DevKit device to configure its connection to IoT Central.
 
 In this how-to article, you:
@@ -99,4 +101,7 @@ To review the code or modify and compile it, go to the [Code Samples](https://do
 
 ## Next steps
 
-Now that you've learned how to connect a DevKit device to your Azure IoT Central application, the suggested next step is to learn how to [set up a custom device template](./howto-set-up-template.md) for your own IoT device.
+If you're a device developer, some suggested next steps are to:
+
+- Read about [Device connectivity in Azure IoT Central](./concepts-get-connected.md)
+- Learn how to [Monitor device connectivity using Azure CLI](./howto-monitor-devices-azure-cli.md)
diff --git a/articles/iot-central/core/howto-connect-rigado-cascade-500.md b/articles/iot-central/core/howto-connect-rigado-cascade-500.md
@@ -12,6 +12,7 @@ ms.date: 11/27/2019
 
 # Connect a Rigado Cascade 500 gateway device to your Azure IoT Central application
 
+*This article applies to solution builders and device developers.*
 
 This article describes how, as a solution builder, you can connect a Rigado Cascade 500 gateway device to your Microsoft Azure IoT Central application. 
 
@@ -65,4 +66,7 @@ You are now ready to use your C500 device in your IoT Central application!
 
 ## Next steps
 
-Now that you've learned how to connect a Rigado Cascade 500 to your Azure IoT Central application, the suggested next step is to learn how to [create an in-store analytics application](../retail/tutorial-in-store-analytics-create-app-pnp.md) to build an end to end solution. 
+If you're a device developer, some suggested next steps are to:
+
+- Read about [Device connectivity in Azure IoT Central](./concepts-get-connected.md)
+- Learn how to [Monitor device connectivity using Azure CLI](./howto-monitor-devices-azure-cli.md)
diff --git a/articles/iot-central/core/howto-connect-ruuvi.md b/articles/iot-central/core/howto-connect-ruuvi.md
@@ -12,6 +12,8 @@ ms.date: 11/27/2019
 
 # Connect a RuuviTag sensor to your Azure IoT Central application
 
+*This article applies to solution builders and device developers.*
+
 This article describes how, as a solution builder, you can connect a RuuviTag sensor to your Microsoft Azure IoT Central application.
 
 What is a Ruuvi tag?
@@ -70,4 +72,7 @@ To create a simulated RuuviTag:
 
 ## Next Steps
 
-Now that you've learned how to connect a RuuviTag to your Azure IoT Central application, the suggested next step is to learn how to [customize your IoT Central application](../retail/tutorial-in-store-analytics-customize-dashboard-pnp.md) to build an end to end solution.
+If you're a device developer, some suggested next steps are to:
+
+- Read about [Device connectivity in Azure IoT Central](./concepts-get-connected.md)
+- Learn how to [Monitor device connectivity using Azure CLI](./howto-monitor-devices-azure-cli.md)
diff --git a/articles/iot-central/core/howto-monitor-devices-azure-cli.md b/articles/iot-central/core/howto-monitor-devices-azure-cli.md
@@ -12,7 +12,7 @@ manager: corywink
 
 # Monitor device connectivity using Azure CLI
 
-*This topic applies to builders and administrators.*
+*This topic applies to device developers and solution builders.*
 
 Use the Azure CLI IoT extension to see messages your devices are sending to IoT Central and observe changes in the device twin. You can use this tool to debug and observe device connectivity and diagnose issues of device messages not reaching the cloud or devices not responding to twin changes.
 
@@ -76,4 +76,4 @@ az iot central device-twin show --app-id <app-id> --device-id <device-id>
 
 ## Next steps
 
-Now that you've learned how to use the IoT Central Explorer, the suggested next step is to explore [managing devices IoT Central](howto-manage-devices.md).
+If you're a device developer, a suggested next step is to read about [Device connectivity in Azure IoT Central](./concepts-get-connected.md).
diff --git a/articles/iot-central/core/howto-set-up-template.md b/articles/iot-central/core/howto-set-up-template.md
@@ -12,6 +12,8 @@ manager: peterpr
 
 # Define a new IoT device type in your Azure IoT Central application
 
+*This article applies to solution builders and device developers.*
+
 A device template is a blueprint that defines the characteristics and behaviors of a type of device that connects to an Azure IoT Central application.
 
 For example, a builder can create a device template for a connected fan that has the following characteristics:
@@ -248,18 +250,6 @@ To publish a device template, go to you your device template, and select **Publi
 
 After you publish a device template, an operator can go to the **Devices** page, and add either real or simulated devices that use your device template. You can continue to modify and save your device template as you're making changes. When you want to push these changes out to the operator to view under the **Devices** page, you must select **Publish** each time.
 
-
 ## Next steps
 
-In this tutorial, you learned how to:
-
-* Create a new IoT device template.
-* Create cloud properties.
-* Create customizations.
-* Define a visualization for the device telemetry.
-* Publish your device template.
-
-Next, you can:
-
-> [!div class="nextstepaction"]
-> [Connect a device](howto-connect-devkit.md)
+If you're a device developer, a suggested next step is to read about [device template versioning](./howto-version-device-template.md).
diff --git a/articles/iot-central/core/howto-version-device-template.md b/articles/iot-central/core/howto-version-device-template.md
@@ -12,7 +12,7 @@ manager: peterpr
 
 # Create a new device template version
 
-
+*This article applies to solution builders and device developers.*
 
 Azure IoT Central allows rapid development of IoT Applications. You can quickly iterate over your device template designs by adding, editing, or deleting device capabilities, views, and customizations. Once you have published your device template, the device capability model shows as **Published** with lock icons next to the model. In order to make changes to the device capability model, you will need to create a new version of the device template. Meanwhile the cloud properties, customizations, and views can all be edited at any time without needing to version the device template. Once you have saved any of these changes, you can publish the device template to make the latest changes available for the operator to view in Device Explorer.
 
@@ -76,7 +76,4 @@ You can create multiple versions of the device template. Over time, you will hav
 
 ## Next steps
 
-Now that you have learned how to use device template versions in your Azure IoT Central application, here is the suggested next step:
-
-> [!div class="nextstepaction"]
-> [How to create telemetry rules](tutorial-create-telemetry-rules.md)
+If you're a device developer, a suggested next step is to read about [Azure IoT Edge devices and Azure IoT Central](./concepts-iot-edge.md).
diff --git a/articles/iot-central/core/overview-iot-central.md b/articles/iot-central/core/overview-iot-central.md
@@ -192,11 +192,13 @@ Each Azure subscription has default quotas that could impact the scope of your I
 
 ## Next steps
 
-Now that you have an overview of IoT Central, here are suggested next steps:
+Now that you have an overview of IoT Central, here are some suggested next steps:
 
 - Understand the available [Azure technologies and services for creating IoT solutions](../../iot-fundamentals/iot-services-and-technologies.md).
 - Familiarize yourself with the [Azure IoT Central UI](overview-iot-central-tour.md).
 - Get started by [creating an Azure IoT Central application](quick-deploy-iot-central.md).
 - Learn more about [IoT Plug and Play (preview)](../../iot-pnp/overview-iot-plug-and-play.md).
 - Learn how to [Connect an Azure IoT Edge device](./tutorial-add-edge-as-leaf-device.md).
 - Learn more about [Azure IoT technologies and services](../../iot-fundamentals/iot-services-and-technologies.md).
+
+If you're a device developer and want to dive into some code, the suggested next step is to [Create and connect a client application to your Azure IoT Central application](./tutorial-connect-device-nodejs.md).
diff --git a/articles/iot-central/core/quick-deploy-iot-central.md b/articles/iot-central/core/quick-deploy-iot-central.md
@@ -54,7 +54,11 @@ To create a new Azure IoT Central application from the **Custom application** te
 
 ## Next steps
 
-In this quickstart, you created an IoT Central application. Here's the suggested next step:
+In this quickstart, you created an IoT Central application. Here's the suggested next step to continue learning about IoT Central:
 
 > [!div class="nextstepaction"]
 > [Add a simulated device to your IoT Central application](./quick-create-simulated-device.md)
+
+If you're a device developer and want to dive into some code, the suggested next step is to:
+> [!div class="nextstepaction"]
+> [Create and connect a client application to your Azure IoT Central application](./tutorial-connect-device-nodejs.md)
diff --git a/articles/iot-central/core/tutorial-add-edge-as-leaf-device.md b/articles/iot-central/core/tutorial-add-edge-as-leaf-device.md
@@ -21,6 +21,8 @@ manager: peterpr
 
 # Tutorial: Add an Azure IoT Edge device to your Azure IoT Central application
 
+*This article applies to solution builders and device developers.*
+
 This tutorial shows you how to configure and add an Azure IoT Edge device to your Azure IoT Central application. The tutorial uses an IoT Edge-enabled Linux virtual machine (VM) from Azure Marketplace to simulate an IoT Edge device. The IoT Edge device uses a module that generates simulated environmental telemetry. You view the telemetry on a dashboard in your IoT Central application.
 
 In this tutorial, you learn how to:
@@ -265,9 +267,9 @@ The **Modules** page shows the status of the IoT Edge modules:
 
 ## Next steps
 
-Now that you've learned how to work with and manage IoT Edge devices in IoT Central, here's the suggested next step:
+As a device developer, now that you've learned how to work with and manage IoT Edge devices in IoT Central, a suggested next step is to read:
 
 <!-- Next how-tos in the sequence -->
 
 > [!div class="nextstepaction"]
-> [Configure transparent gateway](../../iot-edge/how-to-create-transparent-gateway.md)
+> [Get connected to Azure IoT Central](./concepts-get-connected.md)
diff --git a/articles/iot-central/core/tutorial-connect-device-nodejs.md b/articles/iot-central/core/tutorial-connect-device-nodejs.md
@@ -12,10 +12,12 @@ ms.custom:  mqtt
 # As a device developer, I want to try out using Node.js device code that uses the Azure IoT Node.js SDK. I want to understand how to send telemetry from a device, synchronize properties with the device, and control the device using synchronous and asynchronous commands.
 ---
 
-# Tutorial: Create and connect a Node.js client application to your Azure IoT Central application (Node.js)
+# Tutorial: Create and connect a client application to your Azure IoT Central application (Node.js)
 
 [!INCLUDE [iot-central-selector-tutorial-connect](../../../includes/iot-central-selector-tutorial-connect.md)]
 
+*This article applies to solution builders and device developers.*
+
 This tutorial shows you how, as a device developer, to connect a Node.js client application to your Azure IoT Central application. The Node.js application simulates the behavior of an environmental sensor device. You use a sample _device capability model_ to create a _device template_ in IoT Central. You add views to the device template to enable an operator to interact with a device.
 
 In this tutorial, you learn how to:
@@ -323,7 +325,12 @@ You can see how the device responds to commands and property updates:
 
 ## Next steps
 
-To learn more about device capability models and how to create your own device templates, continue to the how-to guide:
+As a device developer, now that you've learned the basics of how to create a device using Node.js, some suggested next steps are to:
+
+- Learn how to connect a real device to IoT Central in the [Connect an MXChip IoT DevKit device to your Azure IoT Central application](./howto-connect-devkit.md) how-to article.
+- Read [Get connected to Azure IoT Central](./concepts-get-connected.md) to learn more about how to register devices with IoT Central and how IoT Central secures device connections.
+
+If you'd prefer to continue through the set of IoT Central tutorials and learn more about building an IoT Central solution, see:
 
 > [!div class="nextstepaction"]
-> [Define a new IoT device type](./howto-set-up-template.md)
+> [Create a gateway device template](./tutorial-define-gateway-device-type.md)
diff --git a/articles/iot-central/core/tutorial-connect-device-python.md b/articles/iot-central/core/tutorial-connect-device-python.md
@@ -11,10 +11,12 @@ services: iot-central
 # As a device developer, I want to try out using Python device code that uses the Azure IoT Python SDK. I want to understand how to send telemetry from a device, synchronize properties with the device, and control the device using synchronous and asynchronous commands.
 ---
 
-# Tutorial: Create and connect a Python client application to your Azure IoT Central application (Python)
+# Tutorial: Create and connect a client application to your Azure IoT Central application (Python)
 
 [!INCLUDE [iot-central-selector-tutorial-connect](../../../includes/iot-central-selector-tutorial-connect.md)]
 
+*This article applies to solution builders and device developers.*
+
 This tutorial shows you how, as a device developer, to connect a Python client application to your Azure IoT Central application. The Python application simulates the behavior of an environmental sensor device. You use a sample _device capability model_ to create a _device template_ in IoT Central. You add views to the device template to enable an operator to interact with a device.
 
 In this tutorial, you learn how to:
@@ -300,7 +302,12 @@ You can see how the device responds to commands and property updates:
 
 ## Next steps
 
-To learn more about device capability models and how to create your own device templates, continue to the how-to guide:
+As a device developer, now that you've learned the basics of how to create a device using Node.js, some suggested next steps are to:
+
+- Learn how to connect a real device to IoT Central in the [Connect an MXChip IoT DevKit device to your Azure IoT Central application](./howto-connect-devkit.md) how-to article.
+- Read [Get connected to Azure IoT Central](./concepts-get-connected.md) to learn more about how to register devices with IoT Central and how IoT Central secures device connections.
+
+If you'd prefer to continue through the set of IoT Central tutorials and learn more about building an IoT Central solution, see:
 
 > [!div class="nextstepaction"]
-> [Define a new IoT device type](./howto-set-up-template.md)
+> [Create a gateway device template](./tutorial-define-gateway-device-type.md)
diff --git a/articles/iot-central/core/tutorial-define-gateway-device-type.md b/articles/iot-central/core/tutorial-define-gateway-device-type.md
@@ -13,7 +13,9 @@ manager: peterpr
 
 # Define a new IoT gateway device type in your Azure IoT Central application
 
-This tutorial shows you, as a builder, how to use a gateway device template to define a gateway device in your IoT Central application. You then configure several downstream devices that connect to your IoT Central application through the gateway device. 
+*This article applies to solution builders and device developers.*
+
+This tutorial shows you, as a solution builder, how to use a gateway device template to define a gateway device in your IoT Central application. You then configure several downstream devices that connect to your IoT Central application through the gateway device. 
 
 In this tutorial, you create a **Smart Building** gateway device template. A **Smart Building** gateway device has relationships with other downstream devices.
 
@@ -202,7 +204,7 @@ In this tutorial, you learned how to:
 > [!NOTE]
 > VS Code based code generation is currently not supported for gateway devices modeled in IoT Central.
 
-Next, you can:
+Next, as a device developer, you can learn how to:
 
 > [!div class="nextstepaction"]
-> [Connect a device](tutorial-connect-device.md)
+> [Add an Azure IoT Edge device to your Azure IoT Central application](tutorial-add-edge-as-leaf-device.md)
