diff --git a/packages/@ember/-internals/runtime/lib/mixins/array.js b/packages/@ember/-internals/runtime/lib/mixins/array.js
index f960c752eac..08467c3e29d 100644
--- a/packages/@ember/-internals/runtime/lib/mixins/array.js
+++ b/packages/@ember/-internals/runtime/lib/mixins/array.js
@@ -510,6 +510,18 @@ const ArrayMixin = Mixin.create(Enumerable, {
     Becomes true whenever the array currently has observers watching changes
     on the array.
 
+    ```javascript
+    let arr = [1, 2, 3, 4, 5];
+    arr.hasArrayObservers; // false
+
+    arr.addArrayObserver(this, {
+      willChange() {
+        console.log('willChange');
+      }
+    });
+    arr.hasArrayObservers; // true
+    ```
+
     @property {Boolean} hasArrayObservers
     @public
   */