Updating docs and adding Control.checkbox to FAQs. Fixes #748

Author: davidkpiano

docs/api/Control.md

@@ -29,6 +29,7 @@ It is a connected component, and will use the `model` prop to connect itself to
 The following pre-defined `<Control>`s are available:
 
 - `<Control>` or `<Control.input>` for standard `<input />` controls
+- `<Control.custom>` for controls without any default prop mapping
 - `<Control.text>` for `<input type="text" />`
 - `<Control.textarea>` for `<textarea></textarea>`
 - `<Control.radio>` for `<input type="radio" />`

docs/api/Field.md

@@ -2,6 +2,8 @@
 
 The `<Field>` component recursively checks its children to see if they can be made into a [`<Control>`](./Control.md). It then maps all of its props over to each created child `<Control>`.
 
+If it reaches an unknown component, such as a `<SpecialComponent>`, it will stop recursing and leave the component as-is. In such cases, it is highly recommended to use `<Control>` over `<Field>` whenever possible.
+
 Example:
 ```jsx
 <Field model="user.favoriteColors">

docs/guides/faqs.md

@@ -89,5 +89,34 @@ You can use `getRef` on `<Field>`, `<Control>`, `<Form>`, or `<LocalForm>` compo
 />
 ```
 
+### How do I set up single/multiple-value checkboxes?
+
+For a single checkbox that represents a model's boolean `true` or `false` value, you can use `<Control.checkbox>` as expected:
+
+```jsx
+// if checked, user.hasPets = true, otherwise false.
+<Control.checkbox model="user.hasPets" />
+```
+
+For multiple checkboxes that represent multiple possible values for a model, append `[]` to the control to indicate that it is a multi-value model:
+
+```jsx
+// if dog and cat are checked, model will be:
+// user.pets = ['dog', 'cat']
+<Control.checkbox model="user.pets[]" value="dog" />
+<Control.checkbox model="user.pets[]" value="cat" />
+<Control.checkbox model="user.pets[]" value="goat" />
+```
+
+For single or multiple checkboxes that represent boolean keyed values in a model that's an object, use standard dot notation:
+
+```jsx
+// if dog and cat are checked, model will be
+// user.pets = { dog: true, cat: true, goat: false }
+<Control.checkbox model="user.pets.dog" />
+<Control.checkbox model="user.pets.cat" />
+<Control.checkbox model="user.pets.goat" />
+```
+
 ### Other Questions and Answers
 - https://github.com/davidkpiano/react-redux-form/issues/675#issuecomment-281164930