Refactor code-style

*   Add more docs to JSDoc

Author: wooorm

index.js

@@ -1,13 +1,20 @@
 /**
- * @typedef {import('hast').Element & {tagName: 'audio'|'canvas'|'embed'|'iframe'|'img'|'math'|'object'|'picture'|'svg'|'video'}} Embedded
- * @typedef {import('hast-util-is-element').AssertPredicate<Embedded>} AssertEmbedded
+ * @typedef {import('hast').Element} Element
  */
 
 import {convertElement} from 'hast-util-is-element'
 
 /**
- * Check if a node is an embedded element.
- * @type {AssertEmbedded}
+ * Check if a node is a embedded content.
+ *
+ * @type {import('hast-util-is-element').AssertPredicate<Element & {tagName: 'audio' | 'canvas' | 'embed' | 'iframe' | 'img' | 'math' | 'object' | 'picture' | 'svg' | 'video'}>}
+ * @param value
+ *   Thing to check (typically `Node`).
+ * @returns
+ *   Whether `value` is an element considered embedded content.
+ *
+ *   The elements `audio`, `canvas`, `embed`, `iframe`, `img`, `math`,
+ *   `object`, `picture`, `svg`, and `video` are embedded content.
  */
 // @ts-expect-error Sure, the assertion matches.
 export const embedded = convertElement([

readme.md

@@ -209,7 +209,7 @@ abide by its terms.
 
 [coc]: https://github.com/syntax-tree/.github/blob/main/code-of-conduct.md
 
-[spec]: https://html.spec.whatwg.org/#embedded-content-2
+[spec]: https://html.spec.whatwg.org/multipage/dom.html#embedded-content-2
 
 [hast]: https://github.com/syntax-tree/hast