From 4ce4d0320702133fefee065126909f20ffe48402 Mon Sep 17 00:00:00 2001 From: Bas Nijholt Date: Sun, 6 Sep 2026 11:59:31 -0700 Subject: [PATCH] Clarify settings needed to adapt unmatched turn-ons --- docs/advanced/manual-control.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/advanced/manual-control.md b/docs/advanced/manual-control.md index cfb48b33..dc099c57 100644 --- a/docs/advanced/manual-control.md +++ b/docs/advanced/manual-control.md @@ -118,7 +118,7 @@ When enabled, a turn-on without a state-change context matching the latest recor Manual-control flags are shared by profiles controlling the same light. Use the same turn-on policy on those profiles; mixed policies can allow an earlier profile to adapt before another marks the light manually controlled. -Enable this if you want turn-ons from physical controls or native scenes to preserve their brightness and color. Leave it disabled if those controls should start normal adaptation. +Enable this if you want turn-ons from physical controls or native scenes to preserve their brightness and color. To adapt unmatched turn-ons, leave this disabled and enable `detect_non_ha_changes`. Its advantage over simply disabling `detect_non_ha_changes` is that the two behaviors are decoupled: you can keep `detect_non_ha_changes: true` to catch manual dimming of lights that are *already on*, while leaving unmatched turn-ons untouched.