Update documentation concerning immutable updates

docs/APIReference-ContentState.md

@@ -142,6 +142,13 @@ objects.
 
 > Use [Immutable Map API](http://facebook.github.io/immutable-js/docs/#/Map) to
 > set properties.
+> 
+> **Example**
+> ```
+> const editorState = EditorState.createEmpty();
+> const contentState = editorState.getCurrentContent();
+> const contentStateWithSelectionBefore = contentState.set('selectionBefore', SelectionState.createEmpty(contentState.getBlockForKey('1pu4d')));
+> ```
 
 <ul class="apiIndex">
   <li>

docs/APIReference-EditorState.md

@@ -118,7 +118,14 @@ The list below includes the most commonly used instance methods for `EditorState
 > Note
 >
 > Use the static `EditorState` methods to set properties, rather than using
-> the Immutable API directly.
+> the Immutable API directly. This means using `EditorState.set` to pass
+> new options to an EditorState instance.
+>
+> **Example**
+> ```
+> const editorState = EditorState.createEmpty();
+> const editorStateWithoutUndo = EditorState.set(editorState, {allowUndo: false});
+> ```
 
 <ul class="apiIndex">
   <li>

docs/APIReference-SelectionState.md

@@ -141,6 +141,13 @@ _Start_ and _end_ values are derived.
 
 > Use [Immutable Map API](http://facebook.github.io/immutable-js/docs/#/Record/Record) to
 > set properties.
+> 
+> **Example**
+> ```
+> const selectionState = SelectionState.createEmpty();
+> const selectionStateWithNewFocusOffset = selection.set('focusOffset', 1);
+> ```
+
 
 <ul class="apiIndex">
   <li>