Improving documentation #268

js/common/model/Material.ts

@@ -87,7 +87,9 @@ export default class Material extends PhetioObject implements MappedWrappedObjec
         phetioDocumentation: 'Density of the material',
         phetioReadOnly: !( providedOptions.hidden || providedOptions.custom ), // Read-only unless it's a mystery or custom material
         rangePropertyOptions: {
-          reentrant: true, // needed for the range mutation in MaterialControlNode, see https://github.com/phetsims/density-buoyancy-common/issues/268
+          // When used in a MaterialControlNode, the component will override the rangeProperty, even when the sim is reset
+          // This is done in a recursive/reentrant link call, so we need to ensure that the value comparison is an equals function
+          reentrant: true,
           valueComparisonStrategy: 'equalsFunction'
         },
         range: new Range( 0.8, 27000 ),