Refactor docs

Author: wooorm

readme.md

@@ -48,7 +48,7 @@ You can instead use [`unist-builder`][u] when creating any unist nodes and
 ## 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 xastscript
@@ -191,7 +191,7 @@ Yields:
 
 ## API
 
-This package exports the identifier [`x`][x].
+This package exports the identifier [`x`][api-x].
 There is no default export.
 
 The export map supports the automatic JSX runtime.
@@ -220,15 +220,15 @@ When nullish, a [`Root`][root] is built instead.
 
 ###### `attributes`
 
-Attributes of the element ([`Attributes`][attributes], optional).
+Attributes of the element ([`Attributes`][api-attributes], optional).
 
 ###### `children`
 
-Children of the node ([`Child`][child] or `Array<Child>`, optional).
+Children of the node ([`Array<Child>`][api-child] or `Child`, optional).
 
 ##### Returns
 
-Created tree ([`Result`][result]).
+Created tree ([`Result`][api-result]).
 
 [`Element`][element] when a `name` is passed, otherwise [`Root`][root].
 
@@ -294,7 +294,7 @@ You should use the automatic JSX runtime set to `xastscript`.
 The Use example above (omitting the second) can then be written like so:
 
 ```jsx
-/** @jsxImportSource x */
+/** @jsxImportSource xastscript */
 
 import {u} from 'unist-builder'
 
@@ -321,15 +321,18 @@ console.log(
 ## Types
 
 This package is fully typed with [TypeScript][].
-It exports the additional types [`Attributes`][attributes], [`Child`][child],
-and [`Result`][result].
+It exports the additional types [`Attributes`][api-attributes],
+[`Child`][api-child], and [`Result`][api-result].
 
 ## 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, `xastscript@^3`, compatible
+with Node.js 12.
 
 ## Security
 
@@ -376,9 +379,9 @@ abide by its terms.
 
 [downloads]: https://www.npmjs.com/package/xastscript
 
-[size-badge]: https://img.shields.io/bundlephobia/minzip/xastscript.svg
+[size-badge]: https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=xastscript
 
-[size]: https://bundlephobia.com/result?p=xastscript
+[size]: https://bundlejs.com/?q=xastscript
 
 [sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg
 
@@ -422,10 +425,10 @@ abide by its terms.
 
 [h]: https://github.com/syntax-tree/hastscript
 
-[x]: #xname-attributes-children
+[api-x]: #xname-attributes-children
 
-[attributes]: #attributes-1
+[api-attributes]: #attributes-1
 
-[child]: #child
+[api-child]: #child
 
-[result]: #result
+[api-result]: #result