From af730bbc583b804a0dc83087a43dc23e92919319 Mon Sep 17 00:00:00 2001
From: Matthias Kestenholz <mk@feinheit.ch>
Date: Wed, 4 Sep 2024 09:45:49 +0200
Subject: [PATCH] Add a note to the activate / decativate event description

---
 docs/index.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/index.rst b/docs/index.rst
index 5b9e5c6c..fefa463a 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -151,6 +151,16 @@ edited and ordered.
         ]
 
 
+.. note::
+
+   The following section is outdated; the content editor uses `flex ordering
+   <https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_flexible_box_layout/Ordering_flex_items>`__
+   since 2018, fixing the problem where moving DOM elements would freeze the
+   associated JavaScript widgets.
+
+   These days it should be enough to initialize widgets on page load and
+   when Django itself emits the `formset:added event <https://docs.djangoproject.com/en/latest/ref/contrib/admin/javascript/>`__.
+
 Here's an example CKEditor integration. Especially noteworthy are the
 two signals emitted by the content editor: ``content-editor:activate``
 and ``content-editor:deactivate``. Since content blocks can be