From 497d0b20b698ded0f575e9f9d2de5b8e30354269 Mon Sep 17 00:00:00 2001
From: Alexei Chetroi <lexoid@gmail.com>
Date: Tue, 29 Sep 2020 17:38:00 -0400
Subject: [PATCH] Address comments for #14643 (#14655)

Co-authored-by: Franck Nijhof <git@frenck.dev>
---
 source/_integrations/zha.markdown | 39 ++++++++++++++++++++-----------
 1 file changed, 26 insertions(+), 13 deletions(-)

diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown
index b4c757cf2c9..50ec8521451 100644
--- a/source/_integrations/zha.markdown
+++ b/source/_integrations/zha.markdown
@@ -146,29 +146,42 @@ To add new devices to the network, call the `permit` service on the `zha` domain
 
 
 ## Services
-### Service `permit`
-This service opens network for joining new devices
+
+### Service `zha.permit`
+
+This service opens network for joining new devices.
 
 |  Data | Optional | Description |
 | ---- | ---- | ----------- |
 | `duration` |  yes | For how long to allow new devices to join, default 60s
 | `ieee` | yes | allow new devices to join via an existing device
-| `src_ieee` | | The IEEE address of the joining ZB3 device. Use with `install_code`
-| `install_code` | | Install Code of the joining device. Use with `src_ieee`
-| `qr_code` | | QR code containing IEEE and Install Code of the joining ZB3 device
 
-* currently `qr_cde` supports QR Install Codes from:
-- Aqara
-- Consciot
-- Embrighten 
+To join a new device using an install code (ZB3 devices) use the following data attributes (must use parameters only
+from the same group:
 
-### Service `remove`
-This service remove an existing device from the network
+|  Data | Parameter Group | Description |
+| ---- | ---- | ----------- |
+| `src_ieee` | install_code | The IEEE address of the joining ZB3 device. Use with `install_code`
+| `install_code` | install_code | Install Code of the joining device. Use with `src_ieee`
+| `qr_code` | qr_code | QR code containing IEEE and Install Code of the joining ZB3 device
+
+<div class='note'>
+
+  Currently `qr_code` supports QR Install Codes from:
+  
+  - Aqara
+  - Consciot
+  - Embrighten
+
+</div>
+
+### Service `zha.remove`
+
+This service remove an existing device from the network.
 
 |  Data | Optional | Description |
 | ---- | ---- | ----------- |
-| `ieee` | no | What device to remove 
-
+| `ieee` | no | IEEE address of the device to remove 
 
 ### OTA firmware updates