update documentation and add visiblePropertyOptions to config, #1046

js/nodes/Node.js

@@ -5272,6 +5272,15 @@ inherit( PhetioObject, Node, {
    */
   initializePhetioObject: function( baseOptions, config ) {
 
+    config = merge( {
+
+      // This option is used to create the instrumented, default PhET-iO visibleProperty. These options should not
+      // be provided if a `visibleProperty` was provided to this Node. This option is a bit buried because it can only
+      // be used when the Node is being instrumented, which is when the default, instrumented visibleProperty is
+      // conditionally created. We don't want to store these on the Node, and thus they aren't support through `mutate()`.
+      visiblePropertyOptions: null
+    }, config );
+
     // Track this, so we only override our visibleProperty once.
     const wasInstrumented = this.isPhetioInstrumented();