diff --git a/masonry/src/widget/widget_state.rs b/masonry/src/widget/widget_state.rs
index 7c837b9d1..89dd56941 100644
--- a/masonry/src/widget/widget_state.rs
+++ b/masonry/src/widget/widget_state.rs
@@ -250,9 +250,11 @@ impl WidgetState {
 
     /// Update to incorporate state changes from a child.
     ///
-    /// This will also clear some requests in the child state.
-    ///
     /// This method is idempotent and can be called multiple times.
+    //
+    // TODO: though this method takes child state mutably, child state currently isn't actually
+    // mutated anymore. This method may start doing so again in the future, so keep taking &mut for
+    // now.
     pub(crate) fn merge_up(&mut self, child_state: &mut WidgetState) {
         self.needs_layout |= child_state.needs_layout;
         self.needs_compose |= child_state.needs_compose;