WTH is a "Quirk" in the Zigbee integration UI/GUI? Suggest instead calling that a "Device Handler", “Device Converter”, or “Device Translator” in ZHA UI/GUI frontend side

Please consider renaming “Quirk” to be called “Zigbee Device Handler” or “Device Handler” instead in the UI/GUI frontend (as listed under “Device info”) of the Zigbee Home Automation integration.

I feel that “Zigbee Device Handlers” or just “Device Handlers” (as in a handler for Zigbee devices) is both correct terminology and might be a little more self-explanatory for ZHA users than only “quirks”?

Other terms that could probably be equally valid to use would be “Device Converter” or “Device Translator” as a quirk’s function is to convert or translate firmware quirks into standard Zigbee specs.

https://github.com/zigpy/zha-device-handlers/blob/dev/README.md#what-the-heck-is-a-quirk

Anyway, I believe that any of the terms “Device Handler”, “Device Converter”, or “Device Translator” should also be much better sentenced for localization if easier to translate than “quirk” as a word on its own?

Though using if “ZHA Device Handler”, “ZHA Device Converter”, or “ZHA Device Translator” was used in the GUI then that could maybe lead to that term being used by more ZHA users for increased community knowledge even if makes for a longer string(?).

Regardless I feel “quick” as a word alone without any related context in the same sentence is both nondescriptive as well as not being industry standard terminology.

Quirks as terminology for the internal function of the integration code can (and will) of course still continue to be used terminology internally in core and for the development of quirks for ZHA.

References:

https://www.home-assistant.io/integrations/zha#zha-exception-and-deviation-handling

https://github.com/zigpy/zha-device-handlers/

https://github.com/zigpy/zha-device-handlers/blob/33eacee9bdb59879eb3a56fcb7290e807c81c837/README.md

https://github.com/zigpy/zha-device-handlers/blob/dev/README.md#what-the-heck-is-a-quirk

FYI, “device handler” and “custom device handler” terminology is also used by Samsung SmartThings (classic):

https://www.google.com/search?q=smartthings+device+handlers

https://www.google.com/search?q=smartthings+device+handler

https://www.google.com/search?q=Zigbee+Device+Handlers

Zigbee2MQTT and IoBroker on the other hand instead use “Converter” as terminology for “Zigbee-Herdsman Converters”:

https://www.zigbee2mqtt.io/how_tos/how_to_support_new_devices.html

This would definitely fit into the streamlining the experience idea

1 Like