Fix create action documentation Fixes #230

Author: marshallswain

docs/service-module.md

@@ -259,15 +259,23 @@ store.dispatch('todos/get', [1, params])
 
 Make sure your returned records have a unique field that matches the `idField` option for the service plugin.
 
-### `create(data)`
-Create one or multiple records.
-- `data {Object|Array}` - if an object is provided, a single record will be created. If an array of objects is provided, multiple records will be created.
+### `create(data|ParamArray)`
+
+Create one or multiple records.  Note that the method is overloaded to accept two types of arguments.  If you want a consistent interface for creating single or multiple records, use the array syntax, described below.  Creating multiple records requires using the `paramArray` syntax.
+
+- `data {Object|ParamArray}` - if an object is provided, a single record will be created.
 
 ```js
 let newTodo = {description: 'write good tests'}
 store.dispatch('todos/create', newTodo)
 ```
 
+- `data {ParamArray}` - if an array is provided, it is assumed to have this structure:
+
+- `ParamArray {Array}` - array containing the two parameters that Feathers' `service.create` method accepts.
+  - `data {Object|Array}` - the data to create. Providing an object creates a single record. Providing an array of objects creates multiple records.
+  - `params {Object}` - optional - an object containing a `query` object. Can be useful in rare situations.
+
 Make sure your returned records have a unique field that matches the `idField` option for the service plugin.
 
 ### `update(paramArray)`