Add some JSDoc

Author: emmenko

src/middleware/thunk.js

@@ -1,3 +1,12 @@
+/**
+ * Given an action that returns a function, delegates its call
+ * to the function itself by passing the control of the dispatching,
+ * otherwise simply dispatch the action.
+ * In other words, it allows to have async actions.
+ *
+ * @param  {Function} getState - allow to access the current state
+ * @return {Function} a new middleware
+ */
 export default function thunkMiddleware(getState) {
   return (next) => {
     const recurse = (action) =>

src/utils/bindActionCreators.js

@@ -1,5 +1,13 @@
 import mapValues from '../utils/mapValues';
 
+/**
+ * Given a list action creators, wrap them to the `dispatch` function
+ * in order to be automatically dispatched when invoked.
+ *
+ * @param  {Object} actionCreators - an object with the action functions
+ * @param  {Function} dispatch
+ * @return {Object} the given object with wrapped actions
+ */
 export default function bindActionCreators(actionCreators, dispatch) {
   return mapValues(actionCreators, actionCreator =>
     (...args) => dispatch(actionCreator(...args))

src/utils/getDisplayName.js

@@ -1,3 +1,9 @@
+/**
+ * Given a React component, return its name to be displayed.
+ *
+ * @param  {React} Component
+ * @return {String} the name of the component
+ */
 export default function getDisplayName(Component) {
   return Component.displayName || Component.name || 'Component';
 }