From 1eed29259820a64a6df4837fd6d5894f3d2f42a5 Mon Sep 17 00:00:00 2001
From: Giacomo Petri <giacomo.petri@usablenet.com>
Date: Fri, 20 Mar 2026 11:09:21 +0100
Subject: [PATCH 1/2] aria-busy update to clarify allowed content when true

---
 index.html | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/index.html b/index.html
index acf717b86..75c23be21 100644
--- a/index.html
+++ b/index.html
@@ -12642,10 +12642,11 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
               user-initiated changes that occur inside the <rref>article</rref> that the user is reading during the busy period.
             </p>
             <p>
-              If changes to a rendered <rref>widget</rref> would create a state where the <rref>widget</rref> is modifying <a href="#mustContain">Allowed Accessibility Child Roles</a> during script
-              execution, authors MAY set <code>aria-busy</code> to <code>true</code> on the <rref>widget</rref> during the update process. For example, if a rendered tree grid required a set of
-              simultaneous updates to multiple discontiguous branches, an alternative to replacing the complete tree element with a single update would be to mark the tree busy while each of the
-              branches are modified.
+              If changes to a rendered <rref>widget</rref> would create a state where the <rref>widget</rref> is modifying <a>accessibility children</a> during script
+              execution, authors MAY set <code>aria-busy</code> to <code>true</code> on the <rref>widget</rref> during the update process. While <code>aria-busy</code> is set to <code>true</code>, 
+			  the <rref>widget</rref> MAY temporarily contain invalid <a>accessibility children</a>. Authors MUST set <code>aria-busy</code> back to <code>false</code> once the update is complete. 
+			  For example, if a rendered tree grid required a set of simultaneous updates to multiple discontiguous branches, an alternative to replacing the complete tree element with a single update 
+			  would be to mark the tree busy while each of the branches are modified, and set <code>aria-busy</code> to <code>false</code> once all updates are complete.
             </p>
           </div>
           <table class="def">

From 96fb1d309a07da4b150ce91df196fa6ff7485a21 Mon Sep 17 00:00:00 2001
From: Giacomo Petri <giacomo.petri@usablenet.com>
Date: Thu, 9 Apr 2026 10:18:10 +0200
Subject: [PATCH 2/2] Apply suggestions from code review

Co-authored-by: Matt King <a11yThinker@Gmail.com>
---
 index.html | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/index.html b/index.html
index 75c23be21..ef02f69b7 100644
--- a/index.html
+++ b/index.html
@@ -12642,9 +12642,12 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
               user-initiated changes that occur inside the <rref>article</rref> that the user is reading during the busy period.
             </p>
             <p>
-              If changes to a rendered <rref>widget</rref> would create a state where the <rref>widget</rref> is modifying <a>accessibility children</a> during script
-              execution, authors MAY set <code>aria-busy</code> to <code>true</code> on the <rref>widget</rref> during the update process. While <code>aria-busy</code> is set to <code>true</code>, 
-			  the <rref>widget</rref> MAY temporarily contain invalid <a>accessibility children</a>. Authors MUST set <code>aria-busy</code> back to <code>false</code> once the update is complete. 
+              If a script needs to change multiple <a>accessibility children</a> of a rendered <rref>widget</rref>,
+              authors MAY temporarily set <code>aria-busy</code> to <code>true</code> on the <rref>widget</rref> before the first change
+              and then set it to <code>false</code> when script execution completes.
+              While <code>aria-busy</code> is set to <code>true</code>, 
+              the <rref>widget</rref> MAY temporarily contain invalid <a>accessibility children</a>.
+              Authors MUST ensure that <code>aria-busy</code> is set to <code>false</code> either when updates are complete or when error conditions prevent their completion.
 			  For example, if a rendered tree grid required a set of simultaneous updates to multiple discontiguous branches, an alternative to replacing the complete tree element with a single update 
 			  would be to mark the tree busy while each of the branches are modified, and set <code>aria-busy</code> to <code>false</code> once all updates are complete.
             </p>