ToC entries and intro

Author: dominicbetts

articles/iot/iot-introduction.md

@@ -5,19 +5,23 @@ author: dominicbetts
 ms.service: iot
 services: iot
 ms.topic: overview
-ms.date: 11/29/2022
+ms.date: 03/24/2023
 ms.author: dobett
 ms.custom:  [amqp, mqtt]
 #Customer intent: As a newcomer to IoT, I want to understand what IoT is, what services are available, and examples of business cases so I can figure out where to start.
 ---
 
 # What is Azure Internet of Things (IoT)?
 
-The Azure Internet of Things (IoT) is a collection of Microsoft-managed cloud services that connect, monitor, and control billions of IoT assets. In simpler terms, an IoT solution is made up of one or more IoT devices that communicate with one or more back-end services hosted in the cloud.
+The Azure Internet of Things (IoT) is a collection of Microsoft-managed cloud services that let you connect, monitor, and control billions of IoT assets. In simpler terms, an IoT solution is made up of IoT devices that communicate with cloud services.
+
+The following diagram shows a high-level view of the components in a typical IoT solution. This article is focused key groups of components: devices, IoT cloud services, other cloud services, and solution-wide concerns. Other articles in this section provide more detail on each of these components.
+
+:::image type="content" source="media/iot-introduction/iot-architecture.svg" alt-text="High-level IoT solution architecture diagram" border="false":::
 
 ## IoT devices
 
-An IoT device is typically made up of a circuit board with sensors attached that use WiFi to connect to the internet. For example:
+An IoT device is typically made up of a circuit board with sensors attached that uses WiFi to connect to the internet. For example:
 
 * A pressure sensor on a remote oil pump.
 * Temperature and humidity sensors in an air-conditioning unit.
@@ -26,23 +30,25 @@ An IoT device is typically made up of a circuit board with sensors attached that
 
 There's a wide variety of devices available from different manufacturers to build your solution. For a list of devices certified to work with Azure IoT Hub, see the [Azure Certified for IoT device catalog](https://devicecatalog.azure.com). For prototyping, you can use devices such as an [MXChip IoT DevKit](https://microsoft.github.io/azure-iot-developer-kit/) or a [Raspberry Pi](https://www.raspberrypi.org/). The Devkit has built-in sensors for temperature, pressure, humidity, and a gyroscope, accelerometer, and magnetometer. The Raspberry Pi lets you attach many different types of sensor.
 
-Microsoft provides open-source [Device SDKs](../iot-hub/iot-hub-devguide-sdks.md) that you can use to build the apps that run on your devices. These [SDKs simplify and accelerate](https://azure.microsoft.com/blog/benefits-of-using-the-azure-iot-sdks-in-your-azure-iot-solution/) the development of your IoT solutions.
+Microsoft provides open-source [Device SDKs](../iot-hub/iot-hub-devguide-sdks.md) that you can use to build the apps that run on your devices.
+
+To learn more, see [IoT device development](iot-overview-device-development.md).
 
-## Communication
+## Connectivity
 
-Typically, IoT devices send telemetry from the sensors to back-end services in the cloud. However, other types of communication are possible such as a back-end service sending commands to your devices. The following are some examples of device-to-cloud and cloud-to-device communication:
+Typically, IoT devices send telemetry from the sensors to cloud services in your solution. However, other types of communication are possible such as a cloud service sending commands to your devices. The following are some examples of device-to-cloud and cloud-to-device communication:
 
 * A mobile refrigeration truck sends temperature every 5 minutes to an IoT Hub.
 
-* The back-end service sends a command to a device to change the frequency at which it sends telemetry to help diagnose a problem.
+* A cloud service sends a command to a device to change the frequency at which it sends telemetry to help diagnose a problem.
 
 * A device sends alerts based on the values read from its sensors. For example, a device monitoring a batch reactor in a chemical plant, sends an alert when the temperature exceeds a certain value.
 
 * Your devices send information to display on a dashboard for viewing by human operators. For example, a control room in a refinery may show the temperature, pressure, and flow volumes in each pipe, enabling operators to monitor the facility.
 
 The [IoT Device SDKs](../iot-hub/iot-hub-devguide-sdks.md) and IoT Hub support common [communication protocols](../iot-hub/iot-hub-devguide-protocols.md) such as HTTP, MQTT, and AMQP.
 
-IoT devices have different characteristics when compared to other clients such as browsers and mobile apps. The device SDKs help you address the challenges of connecting devices securely and reliably to your back-end service.  Specifically, IoT devices:
+IoT devices have different characteristics when compared to other clients such as browsers and mobile apps. The device SDKs help you address the challenges of connecting devices securely and reliably to your cloud services.  Specifically, IoT devices:
 
 * Are often embedded systems with no human operator.
 * Can be deployed in remote locations, where physical access is expensive.
@@ -51,9 +57,11 @@ IoT devices have different characteristics when compared to other clients such a
 * May have intermittent, slow, or expensive network connectivity.
 * May need to use proprietary, custom, or industry-specific application protocols.
 
-## Back-end services
+To learn more, see [Device infrastructure and connectivity](iot-overview-device-connectivity.md).
 
-In an IoT solution, the back-end service provides functionality such as:
+## Cloud services
+
+In an IoT solution, the cloud services provide functionality such as:
 
 * Receiving telemetry at scale from your devices, and determining how to process and store that data.
 * Analyzing the telemetry to provide insights, either in real time or after the fact.
@@ -62,18 +70,23 @@ In an IoT solution, the back-end service provides functionality such as:
 * Controlling the state of your devices and monitoring their activities.
 * Managing the firmware installed on your devices.
 
-For example, in a remote monitoring solution for an oil pumping station, the cloud back end uses telemetry from the pumps to identify anomalous behavior. When the back-end service identifies an anomaly, it can automatically send a command back to the device to take a corrective action. This process generates an automated feedback loop between the device and the cloud that greatly increases the solution efficiency.
+For example, in a remote monitoring solution for an oil pumping station, the cloud back end uses telemetry from the pumps to identify anomalous behavior. When a cloud service identifies an anomaly, it can automatically send a command back to the device to take a corrective action. This process generates an automated feedback loop between the device and the cloud that greatly increases the solution efficiency.
 
-## Azure IoT examples
+Some cloud services, such as IoT Hub and the Device Provisioning Service, are IoT specific. Other cloud services can provide generic services to your solution such as storage and visualizations.
 
-For real-life examples of how organizations use Azure IoT, see [Microsoft Technical Case Studies for IoT](https://microsoft.github.io/techcasestudies/#technology=IoT&sortBy=featured).
+## Solution-wide concerns
 
-For an in-depth discussion of IoT architecture, see the [Microsoft Azure IoT Reference Architecture](/azure/architecture/reference-architectures/iot).
+Any IoT solution has to address the following solution-wide concerns:
 
-## Next steps
+* [Security](iot-security-best-practices.md) including physical security, authentication, authorization, and encryption
+* Solution management including deployment and monitoring.
+* High availability and disaster recovery for all the services in your solution.
+* Scalability for all the services in your solution.
 
-For some actual business cases and the architecture used, see the [Microsoft Azure IoT Technical Case Studies](https://microsoft.github.io/techcasestudies/#technology=IoT&sortBy=featured).
+## Next steps
 
-For some sample projects that you can try out with an IoT DevKit, see the [IoT DevKit Project Catalog](https://microsoft.github.io/azure-iot-developer-kit/docs/projects/).
+Suggested next steps to explore Azure IoT further include:
 
-For a more comprehensive explanation of the different services and how they're used, see [Azure IoT services and technologies](iot-services-and-technologies.md).
+* [IoT device development](iot-overview-device-development.md)
+* [Device infrastructure and connectivity](iot-overview-device-connectivity.md)
+* [Azure IoT services and technologies](iot-services-and-technologies.md).

articles/iot/iot-overview-connectivity.md renamed to articles/iot/iot-overview-device-connectivity.md

@@ -20,7 +20,7 @@ IoT Central applications use the IoT Hub and the Device Provisioning Service (DP
 
 The following diagram shows a high-level view of the components in a typical IoT solution. This article is focused on the connectivity between the devices and the IoT cloud services shown in the diagram.
 
-:::image type="content" source="media/iot-overview-connectivity/iot-architecture.svg" alt-text="High-level IoT solution architecture diagram that highlights device connectivity areas" border="false":::
+:::image type="content" source="media/iot-overview-device-connectivity/iot-architecture.svg" alt-text="High-level IoT solution architecture diagram that highlights device connectivity areas" border="false":::
 
 ## Primitives
 

articles/iot/iot-overview-device-development.md

@@ -123,7 +123,7 @@ Using containers, such as Docker, to run your device code lets you deploy code t
 Azure IoT Edge runs device code in containers. You can use Azure IoT Edge to deploy code modules to your devices. To learn more, see [Develop your own IoT Edge modules](../iot-edge/module-development.md).
 
 > [!TIP]
-> Azure IoT Edge enables multiple scenarios. In addition to running your IoT device code in containers, you can use Azure IoT Edge to run Azure services on your devices and implement [field gateways](iot-overview-connectivity.md#field-gateways). For more information, see [What is Azure IoT Edge?](../iot-edge/about-iot-edge.md)
+> Azure IoT Edge enables multiple scenarios. In addition to running your IoT device code in containers, you can use Azure IoT Edge to run Azure services on your devices and implement [field gateways](iot-overview-device-connectivity.md#field-gateways). For more information, see [What is Azure IoT Edge?](../iot-edge/about-iot-edge.md)
 
 ## Development tools
 
@@ -139,5 +139,5 @@ The following table lists some of the available IoT development tools:
 
 Now that you've seen an overview of device development in Azure IoT solutions, some suggested next steps include:
 
-- [Device infrastructure and connectivity](iot-overview-connectivity.md)
+- [Device infrastructure and connectivity](iot-overview-device-connectivity.md)
 - [Device management and control](iot-overview-device-management.md)

articles/iot/iot-overview-device-management.md

@@ -140,4 +140,4 @@ To learn more, see:
 Now that you've seen an overview of device management and control in Azure IoT solutions, some suggested next steps include
 
 - [IoT device development](iot-overview-device-development.md)
-- [Device infrastructure and connectivity](iot-overview-connectivity.md)
+- [Device infrastructure and connectivity](iot-overview-device-connectivity.md)