Zone integration: update to reflect current SW (#34103)

* Zone integration: update to refelct current SW

- zone can now be fully configured via UI
- add step-by-step instructions
- remove section 'Home zone', it is no longer accurate
  - as there is now always a home zone setup directly during onboarding

* Add step to edit existing zone

* Add imaage title

* Add related topics

* Revert removal of Home Zone section

* Update source/_integrations/zone.markdown

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Update description of home zone

* Onboarding location: add home zone

* Apply suggestions from code review

Co-authored-by: Franck Nijhof <git@frenck.dev>

* Update source/getting-started/onboarding.markdown

* Remove steps on editing the home zone from the general settings

* if defined in YAML, cannot be edited in the UI

* Rephrase

* Rephrase

* Fix indent

* rephrase

* rephrase

* Apply suggestions from code review

Co-authored-by: Stefan Agner <stefan@agner.ch>

* Apply suggestions from code review

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Apply suggestions from code review

* Make intro less technical

* Rephrase

* Remove examples from intro

* Rephrase

* Add ref to presence detection

* expand intro

* Thanks, coderabbitai

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: Franck Nijhof <git@frenck.dev>
Co-authored-by: Stefan Agner <stefan@agner.ch>

source/_integrations/zone.markdown

@@ -10,17 +10,53 @@ ha_codeowners:
   - '@home-assistant/core'
 ha_domain: zone
 ha_integration_type: system
+related:
+  - docs: /docs/configuration/basic/
+    title: Editing basic settings
+  - docs: /docs/organizing/areas/
+    title: Areas
+  - docs: /getting-started/onboarding/
+    title: Onboarding
+  - docs: /getting-started/presence-detection/
+    title: Presence detection
 ---
 
-Zones allow you to specify certain regions on earth (for now). When a device tracker sees a device to be within a zone, the state will take the name from the zone. Zones can also be used as a [trigger](/docs/automation/trigger#zone-trigger) or [condition](/docs/scripts/conditions/#zone-condition) inside automation setups.
+Zones allow you to specify certain regions on a map. They enable [zone presence-detection](/getting-started/presence-detection/). This information can be used in automations. For example, to start the vacuum after you left home or start the heating at home when you leave the office.
 
-Zones can be added and managed through the user interface at {% my zones title="**Settings** > **Areas, labels & zones**" %}.
+Create a zone for each area you want to automate on. For example, work, school, and home. Different technologies can be used to detect presence in these zones. A common method is app-based detection using a mobile phone.
 
-![Screenshot of the UI for adding or editing a zone](/images/integrations/zone/zone_edit_ui.png)
+## About the home zone
 
-You can add a zone in the user interface by specifying the GPS coordinates or dragging the icon on the map. You can adjust the zone radius (except for the Home zone) by changing the size of the zone circle.
+During the [onboarding process](/getting-started/onboarding/), Home Assistant asked for your home location. You either entered this manually or asked Home Assistant to detect it automatically. This location was used to create the home zone with a 100 m radius. The home zone is a special, pre-defined zone with a few characteristics that set it apart from other zones.
 
-Zones can also be configured via {% term "`configuration.yaml`" %}:
+- The name of this zone is defined by the name of your Home Assistant installation name (which defaults to "Home").
+- The home zone cannot be deleted and is designated with the home icon in the zone configuration page.
+- The home zone's location is used by integrations that are location-based. For example, the [Sun integration](/integrations/sun/), which uses it to calculate the position of the sun relative to your home.
+- During onboarding, Home Assistant used the location to define settings such as the unit system and time zone. If you change the location later, unit system and time zone will not be changed automatically anymore.
+- Devices that are in the home zone will not appear on the map in the Home Assistant UI. For example, if you are using your phone for presence detection, you won't see your phone on the Map dashboard while you are at home.
+
+## Adding a new zone or editing zones
+
+1. Go to {% my zones title="**Settings** > **Areas, labels & zones**" %}.
+2. To edit an existing zone, select the edit {% icon "mdi:edit" %} button. To add a new zone, select **Add zone**.
+3. Give your zone a name, for example `Nina's office`, or `school`.
+   - The home zone always has the name of your Home Assistant installation. To change the name of the home, go to {% my general title="**Settings** > **System** > **General**" %}.
+4. Pick any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/) and prefix the name with `mdi:`.
+   - For example, `mdi:school`, `mdi:briefcase`, `mdi:home`, `mdi:cart`, or `mdi:castle`.
+   - For the home zone, the icon cannot be changed.
+5. To change location or radius, under **Edit location**, select edit.
+   - To adjust the location, specify the GPS coordinates or drag the icon on the map
+   - To change the zone radius, change the size of the zone circle or edit the **Radius** in meters.
+
+    ![Screenshot of the UI for adding or editing a zone](/images/integrations/zone/zone_edit_ui.png)
+
+6. If you want to hide the zone from the frontend and not use the zone for device tracker state, enable **Passive**. You can still use it in automations.
+   - For the home zone, **Passive** is not available.
+7. To save your changes, select **Update**.
+
+## Editing zones in YAML
+
+Zones can also be configured via {% term "`configuration.yaml`" %}. If you define these settings in YAML, they cannot be edited in the UI. They will appear greyed out.
 
 ```yaml
 # Example configuration.yaml entry
@@ -74,18 +110,6 @@ passive:
 
 To find the latitude/longitude of a certain place you can use [Google Maps](https://www.google.com/maps/) or [Bing Maps](https://www.bing.com/maps). Just right click and copy the coordinates from there (Bing) or click on the "What is here?" (Google)
 
-## Home zone
-
-If no configuration is given, the `zone` integration will create a zone for home. This zone will use location provided in the `configuration.yaml` file and have a radius of 100 meters. To override this, create a zone configuration in `configuration.yaml` (see above) and name it **'Home'**. Overriding the Home zone via the UI is not supported.
-
-{% note %}
-Devices that are in the zone **'Home'** will not appear on the map in the Home Assistant UI. To apply the changes to the **'Home'** `zone`, you must restart Home Assistant.
-{% endnote %}
-
-## Icons
-
-It is recommended that you pick an icon to use for your zone. Pick any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/) and prefix the name with `mdi:`. For example `mdi:school`, `mdi:briefcase`, `mdi:home`, `mdi:cart`, or `mdi:castle`.
-
 ## State
 
 The state of a zone is a number, which represents the number of

source/getting-started/onboarding.markdown

@@ -30,9 +30,10 @@ After Home Assistant has been [installed](/installation/) on your device, there
        - If you have a Home Assistant Green, start with the [Green documentation on restoring from backup](https://green.home-assistant.io/guides/restore-backup/).
 
 3. Enter the location of your home.
-   - The location is used to configure the time zone, unit system, and currency.
-   - It is also used for automations such as showing the weather, opening the shades at sunrise, or starting the vacuum when you leave the home.
+   - The home location is used to configure the time zone, unit system, and currency.
+   - It is also used to create the home [zone](/integrations/zone/), which designates the area of your home with a default radius of 100 m.
    - You can always change this information later in the settings.
+   - This home zone can be used for automations such as showing the weather, opening the shades at sunrise, or starting the vacuum when you leave the home.
    - After finding your location, select **Next**.
 
     ![Define your location.](/images/getting-started/onboarding_location.png)