From b85878e1eec7f2250f5db7c3110113f89f2e035a Mon Sep 17 00:00:00 2001
From: "J. Nick Koston" <nick@home-assistant.io>
Date: Sat, 21 Feb 2026 20:42:12 -0600
Subject: [PATCH] tweaks

---
 esphome/automation.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/esphome/automation.py b/esphome/automation.py
index c937470eee..fad344fe1f 100644
--- a/esphome/automation.py
+++ b/esphome/automation.py
@@ -64,6 +64,13 @@ def register_action(
     *,
     deferred: bool = False,
 ):
+    """Register an action type.
+
+    Set ``deferred=True`` if this action stores trigger arguments for later
+    execution (e.g. delay, wait_until, script.wait).  This tells the code
+    generator to use owning types (std::string) instead of non-owning views
+    (StringRef) for string arguments, preventing dangling references.
+    """
     return ACTION_REGISTRY.register(name, action_type, schema, deferred=deferred)