Skip to content

Commit eb63d05

Browse files
authored
Update ZHA reporting issues instructions (home-assistant#30612)
1 parent 015cd2b commit eb63d05

1 file changed

Lines changed: 7 additions & 3 deletions

File tree

source/_integrations/zha.markdown

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -611,13 +611,17 @@ LQI (Link Quality Index) values can be hard to interpret for Zigbee. This is bec
611611

612612
### Reporting issues
613613

614-
When reporting issues, please provide the following information in addition to information requested by issue template:
614+
For more details on where and how to report issues, please refer to the [Reporting issues page](/help/reporting_issues/).
615615

616-
1. Debug logs for the issue, see [debug logging](#debug-logging)
617-
2. Model of Zigbee radio being used
616+
When reporting potential bugs related to the ZHA integration on the issues trackers, please always provide the following ZHA/Zigbee-specific information in addition to the information requested by the standard issue template:
617+
618+
1. Debug logs for the issue, see [debug logging](#debug-logging).
619+
2. Exact model and firmware of the Zigbee radio (Zigbee Coordinator adapter) being used.
618620
3. If the issue is related to a specific Zigbee device, provide both the **Zigbee Device Signature** and the **Diagnostics** information.
619621
- Both the **Zigbee Device Signature** and the **Diagnostics** information can be found under {% my integrations title="**Settings** > **Devices & Services**" %}. Select the **Zigbee Home Automation** integration. Then, select **Configure** > **Devices** (pick your device). Select **Zigbee Device Signature** and **Download Diagnostics**, respectively.
620622

623+
Note: Please also make sure you give it your best effort to follow the recommended best practices for avoiding both [pairing/connection difficulties](#best-practices-to-avoid-pairingconnection-difficulties) and [Zigbee interference](#zigbee-interference-avoidance-and-network-rangecoverage-optimization), (which helps free up time for developers).
624+
621625
### Debug logging
622626

623627
To enable debug logging for the ZHA {% term integration %} and radio libraries, add the following [logger](/integrations/logger/) configuration to `configuration.yaml`:

0 commit comments

Comments
 (0)