Updated Immutable Data Stuctures Docs (facebook#9845)

kastentx · gaearon · commit 8057c0a784f6 · 2017-07-11T14:06:11.000+01:00
* updated immutable data structures section * improved immutable clarifications * changes to example immutable code (cherry picked from commit 8f4d307)
diff --git a/docs/docs/optimizing-performance.md b/docs/docs/optimizing-performance.md
@@ -380,10 +380,12 @@ Although `y` was edited, since it's a reference to the same object as `x`, this
 const SomeRecord = Immutable.Record({ foo: null });
 const x = new SomeRecord({ foo: 'bar' });
 const y = x.set('foo', 'baz');
+const z = x.set('foo', 'bar');
 x === y; // false
+x === z; // true
 ```
 
-In this case, since a new reference is returned when mutating `x`, we can safely assume that `x` has changed.
+In this case, since a new reference is returned when mutating `x`, we can use a reference equality check `(x === y)` to verify that the new value stored in `y` is different than the original value stored in `x`.
 
 Two other libraries that can help use immutable data are [seamless-immutable](https://github.com/rtfeldman/seamless-immutable) and [immutability-helper](https://github.com/kolodny/immutability-helper).
 
