Refactor docs

Author: wooorm

readme.md

@@ -1,87 +1,77 @@
-# unist-util-find-all-before [![Build Status](https://img.shields.io/travis/wooorm/unist-util-find-all-before.svg)](https://travis-ci.org/wooorm/unist-util-find-all-before) [![Coverage Status](https://img.shields.io/codecov/c/github/wooorm/unist-util-find-all-before.svg)](https://codecov.io/github/wooorm/unist-util-find-all-before?branch=master)
+# unist-util-find-all-before [![Build Status][travis-badge]][travis] [![Coverage Status][codecov-badge]][codecov]
 
-[**Unist**](https://github.com/wooorm/unist) utility to find nodes before
-another node. Useful when working with [**mdast**](https://github.com/wooorm/mdast)
-or [**retext**](https://github.com/wooorm/retext).
+[**Unist**][unist] utility to find nodes before another node.
 
 ## Installation
 
-[npm](https://docs.npmjs.com/cli/install):
+[npm][]:
 
 ```bash
 npm install unist-util-find-all-before
 ```
 
-**unist-util-find-all-before** is also available for
-[bower](http://bower.io/#install-packages) and [duo](http://duojs.org/#getting-started),
-and as an AMD, CommonJS, and globals module, [uncompressed](unist-util-find-all-before.js)
-and [compressed](unist-util-find-all-before.min.js).
-
 ## Usage
 
 ```js
-var mdast = require('mdast');
+var remark = require('remark');
 var findAllBefore = require('unist-util-find-all-before');
-var inspect = require('unist-util-inspect');
-
-function log(nodes) {
-    console.log(nodes && inspect(nodes));
-    console.log();
-}
-
-mdast.use(function () {
-    return function (ast) {
-        var paragraph = ast.children[0];
-        var children = paragraph.children;
-
-        log(findAllBefore(paragraph, 4));
-        log(findAllBefore(paragraph, children[4]));
-        log(findAllBefore(paragraph, children[4], 'emphasis'));
-    };
-}).process('Some _emphasis_, **strongness**, and `code`.');
+
+var tree = remark().parse('Some _emphasis_, **importance**, and `code`.');
+var paragraph = tree.children[0];
+var code = paragraph.children[paragraph.children.length - 1];
+
+console.log(findAllBefore(paragraph, code, 'text'));
 ```
 
-Yields (note the order of nodes):
-
-```text
-strong[1]
-└─ text: 'strongness'
-text: ', '
-emphasis[1]
-└─ text: 'emphasis'
-text: 'Some '
-
-strong[1]
-└─ text: 'strongness'
-text: ', '
-emphasis[1]
-└─ text: 'emphasis'
-text: 'Some '
-
-emphasis[1]
-└─ text: 'emphasis'
+Yields:
+
+```js
+[ { type: 'text', value: ', and ' },
+  { type: 'text', value: ', ' },
+  { type: 'text', value: 'Some ' } ]
 ```
 
 ## API
 
-### findAllBefore(parent, index|node\[, test])
+### `findAllBefore(parent, node|index[, test])`
+
+Find the first child before `index` (or `node`) in `parent`, that passes `test`
+(when given).
 
-Find the nodes before `index` (or `node`), that pass `test` (when given).
+###### Parameters
 
-**Parameters**:
+*   `parent` ([`Node`][node]) — Context node;
+*   `node` ([`Node`][node]) — Node in `parent`;
+*   `index` (`number`, optional) — Position of a `node` in `parent`;
+*   `test` (`Function`, `string`, or `Node`, optional)
+    — See [`unist-util-is`][is].
 
-*   `parent` (`Node`) — Parent to search in;
+###### Returns
 
-*   `node` (`Node`)
-    — [Node](https://github.com/wooorm/unist#unist-nodes) to search before;
+[`Array.<Node>`][node] — Child nodes of `parent` passing `test`.
 
-*   `index` (`number`) — Position of child to search before;
+## License
 
-*   `test` (`Function`, `string`, or `Node`; optional)
-    — See [`is()`](https://github.com/wooorm/unist-util-is#istest-node-index-parent-context).
+[MIT][license] © [Titus Wormer][author]
 
-**Returns**: `Array.<node>?`. Child nodes of `parent` which pass `test`.
+<!-- Definitions -->
 
-## License
+[travis-badge]: https://img.shields.io/travis/wooorm/unist-util-find-all-before.svg
+
+[travis]: https://travis-ci.org/wooorm/unist-util-find-all-before
+
+[codecov-badge]: https://img.shields.io/codecov/c/github/wooorm/unist-util-find-all-before.svg
+
+[codecov]: https://codecov.io/github/wooorm/unist-util-find-all-before
+
+[npm]: https://docs.npmjs.com/cli/install
+
+[license]: LICENSE
+
+[author]: http://wooorm.com
+
+[unist]: https://github.com/wooorm/unist
+
+[node]: https://github.com/wooorm/unist#node
 
-[MIT](LICENSE) © [Titus Wormer](http://wooorm.com)
+[is]: https://github.com/wooorm/unist-util-is