OpenHAB
/
openhab-docs
mirror of https://github.com/openhab/openhab-docs.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Add tagging guideline (#2484) 

* Add tagging guideline

Signed-off-by: Andrew Fiddian-Green <software@whitebear.ch>

* adopt reviewer suggestion

Co-authored-by: Jacob Laursen <jacob-github@vindvejr.dk>
Signed-off-by: Andrew Fiddian-Green <software@whitebear.ch>

* fix lint error

Signed-off-by: Andrew Fiddian-Green <software@whitebear.ch>

---------

Signed-off-by: Andrew Fiddian-Green <software@whitebear.ch>
Co-authored-by: Jacob Laursen <jacob-github@vindvejr.dk>
pull/2495/head
Andrew Fiddian-Green 2025-05-09 18:40:59 +01:00 committed by GitHub
parent e9202e2417
commit eb248fa81e
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 5 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
developers/bindings/thing-xml.md
View File

@ -984,6 +984,11 @@ e.g. If you have a multi-sensor that measures both temperature and humidity, the
1. Alternatively to the above, if a Thing has multiple functions e.g. "WiZ Ceiling Fans With a Dimmable Bulb" then apply the tag that matches the **PRIMARY** function.
e.g. `Equipment.CeilingFan` in this case.
1. Sometimes an openHAB Thing is a device that commands another piece of equipment that is itself not directly visible in openHAB.
e.g. an electronic dimmer may be hardwired on-site to a conventional light.
Whilst there is no 100% guarantee that the Thing is actually hardwired to such target device, in such cases it is acceptable to tag the Thing (and its Channels) according to the **EXPECTED** target device.
e.g. in the aforementioned example, instead of tagging the dimmer as `Equipment.ControlDevice` it is acceptable to tag it as `Equipment.LightSource`.
1. Here is the actual list of [Semantic Tags](https://github.com/openhab/openhab-core/blob/main/bundles/org.openhab.core.semantics/model/SemanticTags.csv).
The contents of this list are dynamic, and it may be extended from time to time.
If you are an addon developer and you think there is something missing from the list please open an [Issue](https://github.com/openhab/openhab-core/issues) or [Pull Request](https://github.com/openhab/openhab-core/pulls) on GitHub.