Document the subtle difference between load and change.silent. Fixes #703

Author: davidkpiano

docs/api/actions.md

@@ -241,14 +241,16 @@ dispatch(actions.move('foo.bar', 2, 0));
 ## `actions.load(model, value)`
 Dispatches an `actions.change(...)` action that loads (updates) the `model` with `value` silently. It does not trigger any effects of a `CHANGE` action in the form reducer.
 
+It also sets the `.loadedValue` of the model's `field` to the dispatched `value`.
+
 ### Arguments
 - `model` _(String | Function)_: the model whose value will be changed
 - `value` _(any)_: the value to load (update) the model with
 
 ### Notes
 - This action is useful when you need to set an initial model value asynchronously.
 - If the initial model value is available at runtime, prefer setting it as part of the `initialState` of the `modelReducer` instead.
-- This is equivalent to calling `actions.change(model, value, { silent: true })`.
+- This is different than calling `actions.change(model, value, { silent: true })`. Both are similar with one main difference: `actions.load` also updates the `.loadedValue`, whereas a silent change does not.
 
 <h2 id="actions-omit"></h2>
 ## `actions.omit(model, props)`

src/components/form-component.js

@@ -150,7 +150,11 @@ function createFormClass(s = defaultStrategy) {
 
       if (!formValue) return;
 
+      window.c = window.c || 1;
+
       if (!validators && !errors && (modelValue !== nextProps.modelValue)) {
+        console.log(c, 'here');
+        if (window.c++ > 50) return;
         // If the form is invalid (due to async validity)
         // but its fields are valid and the value has changed,
         // the form should be "valid" again.

test/control-component-spec.js

@@ -2029,7 +2029,7 @@ Object.keys(testContexts).forEach((testKey) => {
       });
     });
 
-    describe('non-string/numeric values for custom controls', () => {
+    describe('non-string values for custom controls', () => {
       const initialState = getInitialState({
         extraData: { address: '221B Baker Street' },
       });