Refactor code-style

*   Add more docs to JSDoc

Author: wooorm

index.js

@@ -1,14 +1,20 @@
 /**
  * @typedef {import('hast').Root} Root
- * @typedef {Root['children'][number]|Root} Node
+ * @typedef {import('hast').Content} Content
+ */
+
+/**
+ * @typedef {Content | Root} Node
  */
 
 /**
  * Check whether a `node` is labelable:
- * See: <https://html.spec.whatwg.org/#category-label>.
+ * See: <https://html.spec.whatwg.org/multipage/forms.html#category-label>.
  *
  * @param {Node} node
+ *   Node to check (typically `Element`).
  * @returns {boolean}
+ *   Whether `node` is a labelable element.
  */
 export function labelable(node) {
   return Boolean(

readme.md

@@ -27,8 +27,8 @@
 
 ## What is this?
 
-This package is a small utility that checks if a node is labelable according to
-HTML.
+This package is a small utility that checks if a node is a labelable element
+according to HTML.
 
 ## When should I use this?
 
@@ -206,7 +206,7 @@ abide by its terms.
 
 [coc]: https://github.com/syntax-tree/.github/blob/main/code-of-conduct.md
 
-[spec]: https://html.spec.whatwg.org/#category-label
+[spec]: https://html.spec.whatwg.org/multipage/forms.html#category-label
 
 [hast]: https://github.com/syntax-tree/hast