New docs on action creators

Author: timdorr

docs/recipes/ReducingBoilerplate.md

@@ -49,7 +49,7 @@ dispatch({
 });
 ```
 
-you might write an action creator in a separate file, and import it from your component:
+You might write an action creator in a separate file, and import it from your component:
 
 #### `actionCreators.js`
 
@@ -101,9 +101,9 @@ We just modified how `addTodo` action creator behaves, completely invisible to t
 
 ### Generating Action Creators
 
-Some frameworks like [Flummox](https://github.com/acdlite/flummox) generate action type constants automatically from the action creator function definitions. The idea is that you don’t need to both define `ADD_TODO` constant and `addTodo()` action creator. Under the hood, such solutions still generate action type constants, but they’re created implicitly so it’s a level of indirection.
+Some frameworks like [Flummox](https://github.com/acdlite/flummox) generate action type constants automatically from the action creator function definitions. The idea is that you don’t need to both define `ADD_TODO` constant and `addTodo()` action creator. Under the hood, such solutions still generate action type constants, but they’re created implicitly so it’s a level of indirection and can cause confusion. We recommend creating your action type constants explicitly.
 
-We don’t recommend this approach. If you’re tired of writing simple action creators like:
+ Writing simple action creators can be tiresome and often ends up generating redundant boilerplate code:
 
 ```js
 export function addTodo(text) {
@@ -113,6 +113,14 @@ export function addTodo(text) {
   };
 }
 
+export function editTodo(id, text) {
+  return {
+    type: 'EDIT_TODO',
+    id,
+    text
+  };
+}
+
 export function removeTodo(id) {
   return {
     type: 'REMOVE_TODO',
@@ -121,7 +129,7 @@ export function removeTodo(id) {
 }
 ```
 
-you can always write a function that generates an action creator:
+You can always write a function that generates an action creator:
 
 ```js
 function makeActionCreator(type, ...argNames) {
@@ -134,14 +142,15 @@ function makeActionCreator(type, ...argNames) {
   }
 }
 
-export const addTodo = makeActionCreator('ADD_TODO', 'todo');
-export const removeTodo = makeActionCreator('REMOVE_TODO', 'id');
-```
-
-See [redux-action-utils](https://github.com/insin/redux-action-utils) and [redux-actions](https://github.com/acdlite/redux-actions) for examples of such utilities.
+const ADD_TODO = 'ADD_TODO';
+const EDIT_TODO = 'EDIT_TODO';
+const REMOVE_TODO = 'REMOVE_TODO';
 
-Note that such utilities add magic to your code.  
-Are magic and indirection really worth it to avoid a few extra lines of code?
+export const addTodo = makeActionCreator(ADD_TODO, 'todo');
+export const editTodo = makeActionCreator(EDIT_TODO, 'id', 'todo');
+export const removeTodo = makeActionCreator(REMOVE_TODO, 'id');
+```
+There are also utility libraries to aid in generating action creators, such as [redux-action-utils](https://github.com/insin/redux-action-utils) and [redux-actions](https://github.com/acdlite/redux-actions). These can help with reducing your boilerplate code and adhereing to standards such as [Flux Standard Action (FSA)](https://github.com/acdlite/flux-standard-action). 
 
 ## Async Action Creators