various tidyups

packages/kogan_kettle.yaml

@@ -1,3 +1,30 @@
+#:########################################################################################:#
+# Package: Kogan Kettle MQTT Control
+# File:    kogan_kettle.yaml
+# Version: v1.0.0
+# Date:    2022-10-11
+#
+# Purpose:
+#   Provides kettle temperature monitoring, power control, and selectable
+#   keep-warm temperatures through a Tasmota/TuyaMCU MQTT interface.
+#
+# Behaviour:
+#   - Reads temperature data from the kettle's TuyaReceived MQTT payload.
+#   - Controls kettle power through its MQTT power command topic.
+#   - Maps the keep-warm selector to the kettle's TuyaSend4 commands.
+#
+# Dependencies:
+#   - Home Assistant MQTT integration and broker connectivity.
+#   - The configured Tasmota/TuyaMCU kettle MQTT topics and payload structure.
+#
+# Known Limitation:
+#   - P013-F026 records that temperature parsing assumes a fixed nested JSON
+#     payload. Malformed or unrelated messages may cause template errors.
+#
+# Version History:
+#   - v1.0.0 (2022-10-11): Initial kettle monitoring and control package.
+#:########################################################################################:#
+
 mqtt:
   sensor:
     - unique_id: kettle.temp