Refactor docs

Author: wooorm

readme.md

@@ -57,7 +57,7 @@ That turns hast into HTML.
 ## Install
 
 This package is [ESM only][esm].
-In Node.js (version 16.0+), install with [npm][]:
+In Node.js (version 16+), install with [npm][]:
 
 ```sh
 npm install hast-util-from-html-isomorphic
@@ -66,14 +66,14 @@ npm install hast-util-from-html-isomorphic
 In Deno with [`esm.sh`][esmsh]:
 
 ```js
-import {fromHtmlIsomorphic} from "https://esm.sh/hast-util-from-html-isomorphic@1"
+import {fromHtmlIsomorphic} from 'https://esm.sh/hast-util-from-html-isomorphic@1'
 ```
 
 In browsers with [`esm.sh`][esmsh]:
 
 ```html
 <script type="module">
-  import {fromHtmlIsomorphic} from "https://esm.sh/hast-util-from-html-isomorphic@1?bundle"
+  import {fromHtmlIsomorphic} from 'https://esm.sh/hast-util-from-html-isomorphic@1?bundle'
 </script>
 ```
 
@@ -105,7 +105,8 @@ Yields (positional info and data omitted for brevity):
 
 ## API
 
-This package exports the identifier [`fromHtmlIsomorphic`][fromhtmlisomorphic].
+This package exports the identifier
+[`fromHtmlIsomorphic`][api-from-html-isomorphic].
 There is no default export.
 
 ### `fromHtmlIsomorphic(value[, options])`
@@ -114,9 +115,9 @@ Turn serialized HTML into a hast tree.
 
 ###### Parameters
 
-*   `value` ([`Compatible`][compatible])
+*   `value` (`string`)
     — serialized HTML to parse
-*   `options` ([`Options`][options], optional)
+*   `options` ([`Options`][api-options], optional)
     — configuration
 
 ###### Returns
@@ -184,14 +185,17 @@ followed by browsers such as Chrome and Firefox.
 ## Types
 
 This package is fully typed with [TypeScript][].
-It exports the additional type [`Options`][options].
+It exports the additional type [`Options`][api-options].
 
 ## Compatibility
 
-Projects maintained by the unified collective are compatible with all maintained
+Projects maintained by the unified collective are compatible with maintained
 versions of Node.js.
-As of now, that is Node.js 16.0+.
-Our projects sometimes work with older versions, but this is not guaranteed.
+
+When we cut a new major release, we drop support for unmaintained versions of
+Node.
+This means we try to keep the current release line,
+`hast-util-from-html-isomorphic@^1`, compatible with Node.js 16.
 
 ## Security
 
@@ -240,9 +244,9 @@ abide by its terms.
 
 [downloads]: https://www.npmjs.com/package/hast-util-from-html-isomorphic
 
-[size-badge]: https://img.shields.io/bundlephobia/minzip/hast-util-from-html-isomorphic.svg
+[size-badge]: https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=hast-util-from-html-isomorphic
 
-[size]: https://bundlephobia.com/result?p=hast-util-from-html-isomorphic
+[size]: https://bundlejs.com/?q=hast-util-from-html-isomorphic
 
 [sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg
 
@@ -292,8 +296,6 @@ abide by its terms.
 
 [xast-util-from-xml]: https://github.com/syntax-tree/xast-util-from-xml
 
-[fromhtmlisomorphic]: #fromhtmlisomorphicvalue-options
-
-[options]: #options
+[api-from-html-isomorphic]: #fromhtmlisomorphicvalue-options
 
-[compatible]: https://github.com/vfile/vfile/blob/03efac7/lib/index.js#L16
+[api-options]: #options