From 0d765f08a00189cd5fca07dc0a9da145de45f2e5 Mon Sep 17 00:00:00 2001
From: samreid <reids@colorado.edu>
Date: Fri, 29 May 2020 14:19:46 -0600
Subject: [PATCH] Update documentation, see
 https://github.com/phetsims/scenery/issues/1046

---
 js/nodes/Node.js | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/js/nodes/Node.js b/js/nodes/Node.js
index 175b38dd4..d92866b75 100644
--- a/js/nodes/Node.js
+++ b/js/nodes/Node.js
@@ -3186,6 +3186,10 @@ inherit( PhetioObject, Node, {
   /**
    * Sets what Property our visibleProperty is backed by, so that changes to this provided Property will change this
    * node's visibility, and vice versa.
+   *
+   * Note that all instrumented Nodes create their own instrumented visibleProperty (if one is not passed in as an option).
+   * Once a Node's visibleProperty has been registered with PhET-iO, it cannot be "swapped out" for another.
+   *
    * @public
    *
    * @param {Property.<boolean>|null} property