Add a should (with explanatory note) about keeping related elements together.

dbaron · dbaron · commit 65a26eda3408 · 2023-09-28T16:00:44.000-04:00
diff --git a/source b/source
@@ -59966,6 +59966,12 @@ interface <dfn interface>HTMLDetailsElement</dfn> : <span>HTMLElement</span> {
   data-x="attr-details-open">open</code> attributes in the markup.  This requirement on authors
   forbids such misleading markup.</p>
 
+  <p>Documents that use the <code data-x="attr-details-name">name</code> attribute to group multiple
+  related <code>details</code> elements should keep those related elements together in a containing
+  element (such as a <code>section</code> element).</p>
+
+  <p class="note">Keeping related elements together can be important for accessibility.</p>
+
   <p>The <dfn element-attr for="details"><code data-x="attr-details-open">open</code></dfn> content
   attribute is a <span>boolean attribute</span>. If present, it indicates that both the summary and
   the additional information is to be shown to the user. If the attribute is absent, only the
