Documentation for Interactive Snapshot Update

CHANGELOG.md

@@ -1,5 +1,10 @@
 ## master
 
+### Fixes
+
+* `[doc]` Add information about Interactive Snapshot update
+  ([#5291](https://github.com/facebook/jest/pull/5291))
+
 ## jest 22.1.3
 
 ### Fixes
@@ -28,16 +33,23 @@
 * `[jest-cli]` Make Jest exit without an error when no tests are found in the
   case of `--lastCommit`, `--findRelatedTests`, or `--onlyChanged` options
   having been passed to the CLI
+* `[jest-cli]` Interactive Snapshot Update: allow to review and update
+  individual snapshot failure
+  ([#3831](https://github.com/facebook/jest/pull/3831))
 
 ### Fixes
+
 * `[jest-cli]` Use `import-local` to support global Jest installations.
   ([#5304](https://github.com/facebook/jest/pull/5304))
 * `[jest-runner]` Fix memory leak in coverage reporting
   ([#5289](https://github.com/facebook/jest/pull/5289))
-* `[docs]` Update mention of the minimal version of node supported [#4947](https://github.com/facebook/jest/issues/4947)
-* `[jest-cli]` Fix missing newline in console message ([#5308](https://github.com/facebook/jest/pull/5308))
+* `[docs]` Update mention of the minimal version of node supported
+  [#4947](https://github.com/facebook/jest/issues/4947)
+* `[jest-cli]` Fix missing newline in console message
+  ([#5308](https://github.com/facebook/jest/pull/5308))
 * `[jest-cli]` `--lastCommit` and `--changedFilesWithAncestor` now take effect
-  even when `--onlyChanged` is not specified. ([#5307](https://github.com/facebook/jest/pull/5307))
+  even when `--onlyChanged` is not specified.
+  ([#5307](https://github.com/facebook/jest/pull/5307))
 
 ### Chore & Maintenance
 
@@ -52,9 +64,6 @@
   ([#5279](https://github.com/facebook/jest/pull/5279))
 * `[jest-config]` Fix breaking change in `--testPathPattern`
   ([#5269](https://github.com/facebook/jest/pull/5269))
-
-### Fixes
-
 * `[docs]` Document caveat with mocks, Enzyme, snapshots and React 16
   ([#5258](https://github.com/facebook/jest/issues/5258))
 

docs/SnapshotTesting.md

@@ -121,6 +121,20 @@ You can try out this functionality by cloning the
 [snapshot example](https://github.com/facebook/jest/tree/master/examples/snapshot),
 modifying the `Link` component, and running Jest.
 
+#### Interactive Updates
+
+Snapshots can also be updated one at a time in the Jest watch mode:
+
+![](/jest/img/content/interactiveSnapshot.png)
+
+Once you enter the Interactive Snapshot Updates mode, Jest will walk you though
+the failed snapshots one at a time and give you an opportunity to review the
+failed output.
+
+From here you can choose to update that snapshot or skip to the next:
+
+![](/jest/img/content/interactiveSnapshotUpdate.png)
+
 ### Tests Should Be Deterministic
 
 Your tests should be deterministic. That is, running the same tests multiple