various tidyups

packages/Pool_Controls/pool_light_operation.yaml

@@ -6,12 +6,16 @@
 #   Pool Light Operation
 #
 # FILE:
-#   packages/pool_light_boost_switch.yaml
+#   packages/Pool_Controls/pool_light_operation.yaml
 #
 # VERSION:
-#   V1.1 2026-06-29
+#   V1.2 2026-07-20
 #
 # VERSION HISTORY:
+#   V1.2 2026-07-20
+#     - Corrected the documented package filename.
+#     - Documented the relationship with the native ESPHome controls.
+#
 #   V1.1 2026-06-29
 #     - Tidied layout, comments, naming and automation IDs.
 #     - Added structured package header and section comments.
@@ -38,8 +42,15 @@
 #   Operation topic:
 #     viewroad-commands/poollight-timer/operation
 #
+# DEPENDENCIES:
+#   - switch.esp_poollightpower2_switch provides the real output state.
+#   - The ESPHome pool light device subscribes to the MQTT operation topic.
+#   - Native ESPHome mode, boost, and pool-light-mode entities coexist with
+#     this one-tap control.
+#
 # NOTES:
 #   The input_boolean.timer_light_midnight_pending helper is internal to this package.
+#   Dashboard cards currently use input_boolean.poollights_mode_switch.
 #
 #:########################################################################################:#