Split the performance section so a fresh reader can find the settle order

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
iris-aiandClaude Opus 5 committed 2026-09-14 20:30:15 -04:00
1 parent f486f00ec9
commit 9bfda08f85
1 file changed
+4
+4
View File
@@ -377,6 +377,8 @@ holds a *drawing* keyed on what produced it, and the widget still draws. The
five reference renders and the resize render are byte-identical, and the five reference renders and the resize render are byte-identical, and the
sweep passes. sweep passes.
### Settling a dirty set, and why the order is not free to change
**Why picking any dirty widget does not work, found 2026-09-14.** `try_reuse` **Why picking any dirty widget does not work, found 2026-09-14.** `try_reuse`
asks whether the widget in front of it is dirty and, if not, hands its parent asks whether the widget in front of it is dirty and, if not, hands its parent
the size it last reported. It does not ask whether a dirty widget sits under it the size it last reported. It does not ask whether a dirty widget sits under it
@@ -456,6 +458,8 @@ hits and only two lines differ between the builds. Nothing here rests on that
difference, but it means those two rows are worth re-measuring before anyone difference, but it means those two rows are worth re-measuring before anyone
builds on them. builds on them.
### Dirtying many widgets at once
**A frame that dirties many widgets at once was not being checked, and it is **A frame that dirties many widgets at once was not being checked, and it is
where the settle order shows.** `77bb75e` adds two generated cases -- every where the settle order shows.** `77bb75e` adds two generated cases -- every
declared size changing together, and a spread of widgets marked for redraw declared size changing together, and a spread of widgets marked for redraw