generate docs

Author: jonschlinkert

.verb.md

@@ -1,4 +1,23 @@
 {%= include("install-bower", {save: true}) %}
 
 ## Usage
-{%= apidocs("index.js") %}
+
+Returns the difference between the first array and additional arrays.
+
+```js
+var diff = require('{%= name %}');
+
+var a = ['a', 'b', 'c', 'd'];
+var b = ['b', 'c'];
+
+console.log(diff(a, b))
+//=> ['a', 'd']
+```
+
+## Benchmarks
+
+This library versus [array-differ][], on {%= date() %}:
+
+```
+{%= docs("benchmark/last.md") %}
+```

README.md

@@ -1,33 +1,24 @@
-# arr-diff [![NPM version](https://img.shields.io/npm/v/arr-diff.svg)](https://www.npmjs.com/package/arr-diff) [![Build Status](https://img.shields.io/travis/jonschlinkert/arr-diff.svg)](https://travis-ci.org/jonschlinkert/arr-diff)
+# arr-diff [![NPM version](https://img.shields.io/npm/v/arr-diff.svg?style=flat)](https://www.npmjs.com/package/arr-diff) [![NPM downloads](https://img.shields.io/npm/dm/arr-diff.svg?style=flat)](https://npmjs.org/package/arr-diff) [![Build Status](https://img.shields.io/travis/jonschlinkert/arr-diff.svg?style=flat)](https://travis-ci.org/jonschlinkert/arr-diff)
 
-> Returns an array with only the unique values from the first array, by excluding all values from additional arrays using strict equality for comparisons.
+Returns an array with only the unique values from the first array, by excluding all values from additional arrays using strict equality for comparisons.
 
 ## Install
 
-Install with [npm](https://www.npmjs.com/)
+Install with [npm](https://www.npmjs.com/):
 
 ```sh
-$ npm i arr-diff --save
+$ npm install arr-diff --save
 ```
+
 Install with [bower](http://bower.io/)
 
 ```sh
 $ bower install arr-diff --save
 ```
 
-## API
-
-### [diff](index.js#L33)
-
-Return the difference between the first array and additional arrays.
-
-**Params**
+## Usage
 
-* `a` **{Array}**
-* `b` **{Array}**
-* `returns` **{Array}**
-
-**Example**
+Returns the difference between the first array and additional arrays.
 
 ```js
 var diff = require('arr-diff');
@@ -39,36 +30,70 @@ console.log(diff(a, b))
 //=> ['a', 'd']
 ```
 
+## Benchmarks
+
+This library versus [array-differ](https://github.com/sindresorhus/array-differ), on May 07, 2016:
+
+```
+# benchmark/fixtures/long.js (94529 bytes)
+  current x 1,246 ops/sec ±0.98% (85 runs sampled)
+  array-differ x 993 ops/sec ±1.35% (87 runs sampled)
+
+# benchmark/fixtures/med.js (708 bytes)
+  current x 583,612 ops/sec ±1.24% (87 runs sampled)
+  array-differ x 464,480 ops/sec ±1.42% (85 runs sampled)
+
+# benchmark/fixtures/short.js (60 bytes)
+  current x 788,823 ops/sec ±0.95% (89 runs sampled)
+  array-differ x 521,483 ops/sec ±1.65% (86 runs sampled)
+```
+
 ## Related projects
 
+You might also be interested in these projects:
+
 * [arr-flatten](https://www.npmjs.com/package/arr-flatten): Recursively flatten an array or arrays. This is the fastest implementation of array flatten. | [homepage](https://github.com/jonschlinkert/arr-flatten)
 * [array-filter](https://www.npmjs.com/package/array-filter): Array#filter for older browsers. | [homepage](https://github.com/juliangruber/array-filter)
 * [array-intersection](https://www.npmjs.com/package/array-intersection): Return an array with the unique values present in _all_ given arrays using strict equality… [more](https://www.npmjs.com/package/array-intersection) | [homepage](https://github.com/jonschlinkert/array-intersection)
 
-## Running tests
+## Contributing
 
-Install dev dependencies:
+Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/jonschlinkert/arr-diff/issues/new).
+
+## Building docs
+
+Generate readme and API documentation with [verb](https://github.com/verbose/verb):
 
 ```sh
-$ npm i -d && npm test
+$ npm install verb && npm run docs
 ```
 
-## Contributing
+Or, if [verb](https://github.com/verbose/verb) is installed globally:
 
-Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/jonschlinkert/arr-diff/issues/new).
+```sh
+$ verb
+```
+
+## Running tests
+
+Install dev dependencies:
+
+```sh
+$ npm install -d && npm test
+```
 
 ## Author
 
 **Jon Schlinkert**
 
-+ [github/jonschlinkert](https://github.com/jonschlinkert)
-+ [twitter/jonschlinkert](http://twitter.com/jonschlinkert)
+* [github/jonschlinkert](https://github.com/jonschlinkert)
+* [twitter/jonschlinkert](http://twitter.com/jonschlinkert)
 
 ## License
 
-Copyright © 2015 [Jon Schlinkert](https://github.com/jonschlinkert)
-Released under the MIT license.
+Copyright © 2016, [Jon Schlinkert](https://github.com/jonschlinkert).
+Released under the [MIT license](https://github.com/jonschlinkert/arr-diff/blob/master/LICENSE).
 
 ***
 
-_This file was generated by [verb](https://github.com/verbose/verb) on Sat Dec 05 2015 23:24:53 GMT-0500 (EST)._
+_This file was generated by [verb](https://github.com/verbose/verb), v0.9.0, on May 07, 2016._