From ba129995d2436f74ef95f0e3c1b4bd87c7f2250e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20CROMBEZ?=
 <777666+jcrombez@users.noreply.github.com>
Date: Thu, 20 Apr 2023 12:07:34 +0200
Subject: [PATCH] Update index.rst

---
 src/LiveComponent/doc/index.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/LiveComponent/doc/index.rst b/src/LiveComponent/doc/index.rst
index ab6f5373b69..e63dc3d72c0 100644
--- a/src/LiveComponent/doc/index.rst
+++ b/src/LiveComponent/doc/index.rst
@@ -2693,6 +2693,7 @@ The system doesn't handle every edge case, so here are some things to keep in mi
 * If an element is moved from one location in the component to another,
   that change is **lost**: the element will be re-added in its original location
   during the next re-render.
+* If a stimulus controller element is moved, depending on your DOM structure, the controller might not follow the element and get applied to another element and break your logic. To help the rendering system to be smarter you should use the `data-live-id` attribute on those elements.
 
 Skipping Updating Certain Elements
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~