device-request.md: Add more guidance and hints; use comments and headings
---
name: Device Request
-about: This form helps in requesting a new device to be supported.
-title: "[DEVICE SUPPORT REQUEST] - Devicename"
+about: Request a new device to be supported.
+title: "Device Support: Device name"
labels: Device Request
assignees: ''
---
-Before requesting a device, please make sure to search the open and closed issues for any requests in the past. Sometimes devices have been requested before but are not implemented yet due to various reasons. If there are no hits on your Product Number, please proceed.
+<!--
+ - Before requesting a device, please make sure to search the open and closed issues for any requests in the past.
+ - Sometimes devices have been requested before but are not implemented yet due to various reasons.
+ - If there are no hits on your for the device, please proceed.
+ - If you're unsure if the device support is already requested, please ask for advise in our Discord chat: https://discord.gg/QFhTxqN
-**Device Name:**
+-->
-**Device Type:**
-- [ ] Light
-- [ ] Lock
-- [ ] Remote
-- [ ] Sensor
-- [ ] Siren
-- [ ] Thermostat
-- [ ] Other:
+## Device
-**Device Manufacturer as per deCONZ GUI basic cluster:**
+- Product name: The device name as shown on the product or package.
+- Device Type: (Light / Lock / Remote / Sensor / Siren / Thermostat)
+- Manufacturer: As per deCONZ GUI Basic cluster.
+- Model identifier: As per deCONZ GUI Basic cluster.
-**Device model identifier as per deCONZ GUI basic cluster:**
+<!--
+ Please refer to https://github.com/dresden-elektronik/deconz-rest-plugin/wiki/Request-Device-Support
+ on how the Basic Cluster attributes are optained.
+-->
-**If you do not know what is needed, please read [this](https://github.com/dresden-elektronik/deconz-rest-plugin/wiki/Request-Device-Support)**
+## Screenshots
-**Screenshot of Clusters of the Node:**
+<!--
+ Screenshots help to identify the device and it's capabilities. Please refer to:
+ https://github.com/dresden-elektronik/deconz-rest-plugin/wiki/Request-Device-Support
+ for examples of the required screenshots.
-**Screenshot of the node info panel:**
+ Required screenshots:
+ - Endpoints and clusters of the node
+ - Node Info panel
+ - Basic Cluster attributes in the Cluster Info panel.
-**Screenshot of the basic clusters attributes as shown in the Clusters info panel with the data returned by read:**
- *Basic cluster's attributes as shown in the Cluster Info Panel, with the data returned by read. Please note that at least "Manufacturer Name" and "Model Identifier" must be populated with data (therefore, must not be empty), otherwise that information will not be usable. For battery powered devices, after pressing read it is required to wake-up the device by pressing a button or any other means of interaction.*
+ In the Cluster Info panel press "read" button to retreive the values. Please note that at least "Manufacturer Name" and "Model Identifier" must be populated with data (therefore, must not be empty), otherwise that information will not be usable. For battery powered devices, after pressing read it is required to wake-up the device by pressing a button or any other means of interaction.
+-->
-**Screenshots of the other clusters (if available:**
-*Further clusters (if available) including Simple Metering, Electrical Measurement, Power Configuration, Thermostat, etc. You can typically spare indentify, alarms, device temperature, on/off. Again, please ensure data has been read prior to taking any screenshots.*
+<!--
+ If available add screenshots of other clusters.
+
+ Relevant clusters are: Simple Metering, Electrical Measurement, Power Configuration, Thermostat, etc. You can typically spare Identify, Alarms, Device Temperature, On/Off. Please ensure data has been read prior to taking any screenshots.
+-->
