Document new Airzone cloud integration (#27456)

* airzone_cloud: add documentation

Signed-off-by: Álvaro Fernández Rojas <noltari@gmail.com>

* airzone_cloud: fix copy&paste typo

Signed-off-by: Álvaro Fernández Rojas <noltari@gmail.com>

* Update source/_integrations/airzone_cloud.markdown

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

* Update source/_integrations/airzone_cloud.markdown

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

* Update source/_integrations/airzone_cloud.markdown

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

* Update source/_integrations/airzone_cloud.markdown

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

* Update source/_integrations/airzone_cloud.markdown

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

* Update source/_integrations/airzone_cloud.markdown

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

* airzone_cloud: adjust Sensors table

Signed-off-by: Álvaro Fernández Rojas <noltari@gmail.com>

* airzone_cloud: tweak description a little bit

Signed-off-by: Álvaro Fernández Rojas <noltari@gmail.com>

* Fix typo

---------

Signed-off-by: Álvaro Fernández Rojas <noltari@gmail.com>
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

source/_integrations/airzone_cloud.markdown

@@ -0,0 +1,39 @@
+---
+title: Airzone Cloud
+description: Instructions on how to integrate Airzone Cloud within Home Assistant.
+ha_release: 2023.6
+ha_category:
+  - Sensor
+ha_iot_class: Cloud Polling
+ha_config_flow: true
+ha_domain: airzone_cloud
+ha_platforms:
+  - sensor
+ha_codeowners:
+  - '@Noltari'
+ha_integration_type: integration
+---
+
+This integration interacts with the Cloud API of [Airzone HVAC zoning systems](https://www.airzone.es/en/).
+
+A typical Airzone HVAC system consists of a parent device (called *master zone* in Airzone terminology) and child devices (called *slave zones* in Airzone terminology). The [HVAC mode](https://www.home-assistant.io/integrations/climate/#service-climateset_hvac_mode) can only be changed on the parent device. On child devices, you can only enable or disable the HVAC and adjust the desired temperature for that specific device.
+
+Note that multiple HVAC systems can be connected to the same Airzone web server. In this case, there will be one *parent zone* per HVAC system and there may also be *child zones* for each HVAC system.
+
+{% include integrations/config_flow.md %}
+
+{% configuration_basic %}
+Username:
+  description: "Cloud API username"
+Password:
+  description: "Cloud API password"
+{% endconfiguration_basic %}
+
+## Sensors
+
+For each Airzone zone (thermostat), the following *sensors* are created:
+
+| Condition           | Description                                         |
+| :------------------ | :-------------------------------------------------- |
+| humidity            | Measures the relative humidity in the current zone. |
+| temperature         | Measures the temperature  in the current zone.      |