run verb to generate readme

Author: jonschlinkert

.verb.md

@@ -1,12 +1,41 @@
 ## Usage
 
 ```js
-var findPkg = require('{%= name %}');
+const findPkg = require('{%= name %}');
+```
+
+**promise**
+
+```js
+findPkg('a/b/c/some/path')
+  .then(file => console.log(file)) //=> /User/jonschlinkert/dev/a/b/package.json
+  .catch(console.error);
+```
+
+**async-await**
 
-findPkg('.', function(err, fp) {
-  //=> /User/jonschlinkert/dev/find-pkg/package.json
+
+```js
+(async function() {
+  const file = await findPkg('a/b/c/some/path');
+  console.log(file);
+  //=> '/Users/jonschlinkert/dev/a/b/package.json'
+})();
+```
+
+**callback**
+
+```js
+findPkg('a/b/c/some/path', function(err, file) {
+  if (err) throw err;
+  console.log(file);
+  //=> '/Users/jonschlinkert/dev/a/b/package.json'
 });
+```
+
+**sync**
 
-var fp = findPkg.sync('.');
-//=> /User/jonschlinkert/dev/find-pkg/package.json
+```js
+const file = findPkg.sync('a/b/c/some/path');
+//=> '/Users/jonschlinkert/dev/a/b/package.json'
 ```

README.md

@@ -2,6 +2,8 @@
 
 > Find the first directory with a package.json, recursing up, starting with the given directory. Similar to look-up but does not support globs and only searches for package.json. Async and sync.
 
+Please consider following this project's author, [Jon Schlinkert](https://github.com/jonschlinkert), and consider starring the project to show your :heart: and support.
+
 ## Install
 
 Install with [npm](https://www.npmjs.com/):
@@ -13,31 +15,66 @@ $ npm install --save find-pkg
 ## Usage
 
 ```js
-var findPkg = require('find-pkg');
+const findPkg = require('find-pkg');
+```
+
+**promise**
+
+```js
+findPkg('a/b/c/some/path')
+  .then(file => console.log(file)) //=> /User/jonschlinkert/dev/a/b/package.json
+  .catch(console.error);
+```
+
+**async-await**
+
+```js
+(async function() {
+  const file = await findPkg('a/b/c/some/path');
+  console.log(file);
+  //=> '/Users/jonschlinkert/dev/a/b/package.json'
+})();
+```
 
-findPkg('.', function(err, fp) {
-  //=> /User/jonschlinkert/dev/find-pkg/package.json
+**callback**
+
+```js
+findPkg('a/b/c/some/path', function(err, file) {
+  if (err) throw err;
+  console.log(file);
+  //=> '/Users/jonschlinkert/dev/a/b/package.json'
 });
+```
+
+**sync**
 
-var fp = findPkg.sync('.');
-//=> /User/jonschlinkert/dev/find-pkg/package.json
+```js
+const file = findPkg.sync('a/b/c/some/path');
+//=> '/Users/jonschlinkert/dev/a/b/package.json'
 ```
 
 ## About
 
-### Related projects
+<details>
+<summary><strong>Contributing</strong></summary>
 
-* [find-file-up](https://www.npmjs.com/package/find-file-up): Find a file, starting with the given cwd and recursively searching up one directory until… [more](https://github.com/jonschlinkert/find-file-up) | [homepage](https://github.com/jonschlinkert/find-file-up "Find a file, starting with the given cwd and recursively searching up one directory until it's found (or we run out of directories). Async and sync.")
-* [load-module-pkg](https://www.npmjs.com/package/load-module-pkg): Load the package.json for any project currently installed in node_modules. | [homepage](https://github.com/jonschlinkert/load-module-pkg "Load the package.json for any project currently installed in node_modules.")
-* [load-pkg](https://www.npmjs.com/package/load-pkg): Loads the package.json from the root of the user's current project. | [homepage](https://github.com/jonschlinkert/load-pkg "Loads the package.json from the root of the user's current project.")
-* [look-up](https://www.npmjs.com/package/look-up): Faster drop-in replacement for find-up and findup-sync. | [homepage](https://github.com/jonschlinkert/look-up "Faster drop-in replacement for find-up and findup-sync.")
-* [module-root](https://www.npmjs.com/package/module-root): Get the resolved path the root (directory) of a package installed in node_modules. | [homepage](https://github.com/jonschlinkert/module-root "Get the resolved path the root (directory) of a package installed in node_modules.")
+Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](../../issues/new).
 
-### Contributing
+</details>
 
-Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](../../issues/new).
+<details>
+<summary><strong>Running Tests</strong></summary>
+
+Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:
+
+```sh
+$ npm install && npm test
+```
 
-### Building docs
+</details>
+
+<details>
+<summary><strong>Building docs</strong></summary>
 
 _(This project's readme.md is generated by [verb](https://github.com/verbose/verb-generate-readme), please don't edit the readme directly. Any changes to the readme must be made in the [.verb.md](.verb.md) readme template.)_
 
@@ -47,26 +84,29 @@ To generate the readme, run the following command:
 $ npm install -g verbose/verb#dev verb-generate-readme && verb
 ```
 
-### Running tests
+</details>
 
-Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:
+### Related projects
 
-```sh
-$ npm install && npm test
-```
+You might also be interested in these projects:
+
+* [find-file-up](https://www.npmjs.com/package/find-file-up): Find a file fast, by starting at the given cwd and recursing up one directory… [more](https://github.com/jonschlinkert/find-file-up) | [homepage](https://github.com/jonschlinkert/find-file-up "Find a file fast, by starting at the given cwd and recursing up one directory until the file is found or we run out of directories.")
+* [findup-sync](https://www.npmjs.com/package/findup-sync): Find the first file matching a given pattern in the current directory or the nearest… [more](https://github.com/js-cli/node-findup-sync#readme) | [homepage](https://github.com/js-cli/node-findup-sync#readme "Find the first file matching a given pattern in the current directory or the nearest ancestor directory.")
+* [global-modules](https://www.npmjs.com/package/global-modules): The directory used by npm for globally installed npm modules. | [homepage](https://github.com/jonschlinkert/global-modules "The directory used by npm for globally installed npm modules.")
 
 ### Author
 
 **Jon Schlinkert**
 
-* [github/jonschlinkert](https://github.com/jonschlinkert)
-* [twitter/jonschlinkert](https://twitter.com/jonschlinkert)
+* [LinkedIn Profile](https://linkedin.com/in/jonschlinkert)
+* [GitHub Profile](https://github.com/jonschlinkert)
+* [Twitter Profile](https://twitter.com/jonschlinkert)
 
 ### License
 
-Copyright © 2017, [Jon Schlinkert](https://github.com/jonschlinkert).
+Copyright © 2018, [Jon Schlinkert](https://github.com/jonschlinkert).
 Released under the [MIT License](LICENSE).
 
 ***
 
-_This file was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme), v0.6.0, on May 20, 2017._
+_This file was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme), v0.6.0, on March 28, 2018._