Refactor docs

Author: wooorm

readme.md

@@ -43,7 +43,7 @@ and similar to [`hastscript`][hastscript].
 ## Install
 
 This package is [ESM only][esm].
-In Node.js (version 14.14+ and 16.0+), install with [npm][]:
+In Node.js (version 16+), install with [npm][]:
 
 ```sh
 npm install hast-util-from-selector
@@ -98,7 +98,7 @@ Yields:
 
 ## API
 
-This package exports the identifier [`fromSelector`][fromselector].
+This package exports the identifier [`fromSelector`][api-from-selector].
 There is no default export.
 
 ### `fromSelector(selector?[, options])`
@@ -107,9 +107,9 @@ Create one or more [`Element`][element]s from a CSS selector.
 
 ###### Parameters
 
-*   `selector` (`string`, optional)
+*   `selector` (`string`, default: `''`)
     — CSS selector
-*   `options` ([`Options`][options], optional)
+*   `options` ([`Options`][api-options], optional)
     — configuration
 
 ###### Returns
@@ -122,7 +122,7 @@ Configuration (TypeScript type).
 
 ###### Fields
 
-*   `space` ([`Space`][space], optional)
+*   `space` ([`Space`][api-space], default: `'html'`)
     — which space first element in the selector is in.
     When an `svg` element is created in HTML, the space is automatically
     switched to SVG
@@ -153,14 +153,18 @@ type Space = 'html' | 'svg'
 ## Types
 
 This package is fully typed with [TypeScript][].
-It exports the additional types [`Options`][options] and [`Space`][space].
+It exports the additional types [`Options`][api-options] and
+[`Space`][api-space].
 
 ## 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 14.14+ and 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-selector@^2`, compatible with Node.js 12.
 
 ## Security
 
@@ -204,9 +208,9 @@ abide by its terms.
 
 [downloads]: https://www.npmjs.com/package/hast-util-from-selector
 
-[size-badge]: https://img.shields.io/bundlephobia/minzip/hast-util-from-selector.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-selector
 
-[size]: https://bundlephobia.com/result?p=hast-util-from-selector
+[size]: https://bundlejs.com/?q=hast-util-from-selector
 
 [sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg
 
@@ -250,8 +254,8 @@ abide by its terms.
 
 [hastscript]: https://github.com/syntax-tree/hastscript
 
-[fromselector]: #fromselectorselector-options
+[api-from-selector]: #fromselectorselector-options
 
-[options]: #options
+[api-options]: #options
 
-[space]: #space
+[api-space]: #space