Add improved jsdoc

index.js

@@ -9,6 +9,19 @@
 
 import {convert} from 'unist-util-is'
 
+/**
+ * Find the first node in `parent` before another `node` or before an index,
+ * that passes `test`.
+
+ * @param parent
+ *   Parent node.
+ * @param index
+ *   Child of `parent`, or it’s index.
+ * @param [test]
+ *   `unist-util-is`-compatible test.
+ * @returns
+ *
+ */
 export const findBefore =
   /**
    * @type {(
@@ -18,9 +31,9 @@ export const findBefore =
    */
   (
     /**
-     * @param {Parent} parent Parent node
-     * @param {Node|number} index Child of `parent`, or it’s index
-     * @param {null|undefined|Type|Props|TestFunctionAnything|Array<Type|Props|TestFunctionAnything>} [test] is-compatible test (such as a type)
+     * @param {Parent} parent
+     * @param {Node|number} index
+     * @param {null|undefined|Type|Props|TestFunctionAnything|Array<Type|Props|TestFunctionAnything>} [test]
      * @returns {Node|null}
      */
     function (parent, index, test) {

readme.md

@@ -92,7 +92,7 @@ There is no default export.
 
 ### `findBefore(parent, node|index[, test])`
 
-Find the first node in `parent` ([`Parent`][parent]) before another node
+Find the first node in `parent` ([`Parent`][parent]) before another `node`
 ([`Node`][node]) or before an index, that passes `test` (`Test` from
 [`unist-util-is`][test]).