diff --git a/packages/flutter/lib/src/rendering/node.dart b/packages/flutter/lib/src/rendering/node.dart
index 18e07f93584..caaa8261103 100644
--- a/packages/flutter/lib/src/rendering/node.dart
+++ b/packages/flutter/lib/src/rendering/node.dart
@@ -69,6 +69,10 @@ class AbstractNode {
   Object _owner;
 
   /// Whether this node is in a tree whose root is attached to something.
+  ///
+  /// This becomes true during the call to [attach].
+  ///
+  /// This becomes false during the call to [detach].
   bool get attached => _owner != null;
 
   /// Mark this node as attached to the given owner.