various tidyups

packages/Pool_Controls/pool_timers_selections.yaml

@@ -6,12 +6,16 @@
 #   Pool Timer Selection
 #
 # FILE:
-#   pool_timer_selection.yaml
+#   packages/Pool_Controls/pool_timers_selections.yaml
 #
 # VERSION:
-#   V1.0 2026-06-29
+#   V1.1 2026-07-20
 #
 # VERSION HISTORY:
+#   V1.1 2026-07-20
+#     - Corrected the documented package filename.
+#     - Documented command selectors versus ESPHome timer feedback.
+#
 #   V1.0 2026-06-29
 #     - Initial package.
 #     - Adds Home Assistant input_select helpers for Pool Pump and Pool Light timer times.
@@ -36,6 +40,16 @@
 #
 #   Payload format is HH:MM.
 #
+# STATUS AND FEEDBACK:
+#   - These input_select helpers send retained MQTT commands to ESPHome.
+#   - They do not synchronize their displayed options from the ESPHome devices.
+#   - The ESPHome Timeclock sensors are authoritative for the currently applied
+#     timer values.
+#   - A selector displaying "Default" does not prove that the device currently
+#     uses its default time.
+#   - Native ESPHome mode controls coexist with this package, while timer
+#     schedule changes continue to use the MQTT topics above.
+#
 # IMPORTANT:
 #   The current ESPHome timer logic only handles same-day timer windows:
 #     current_mins >= on_time AND current_mins < off_time