Refactor docs

Author: wooorm

readme.md

@@ -43,7 +43,7 @@ If you have code, use something like [SWC][] or [esbuild][] instead.
 ## 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 estree-util-build-jsx
@@ -91,10 +91,10 @@ console.log(
 
 ```js
 import fs from 'node:fs/promises'
+import jsx from 'acorn-jsx'
 import {fromJs} from 'esast-util-from-js'
 import {buildJsx} from 'estree-util-build-jsx'
 import {toJs} from 'estree-util-to-js'
-import jsx from 'acorn-jsx'
 
 const doc = String(await fs.readFile('example.jsx'))
 
@@ -123,7 +123,7 @@ console.log(x(null, null, 1 + 1, x("self-closing"), x("x", Object.assign({
 
 ## API
 
-This package exports the identifier [`buildJsx`][build-jsx].
+This package exports the identifier [`buildJsx`][api-build-jsx].
 There is no default export.
 
 ### `buildJsx(tree[, options])`
@@ -147,7 +147,7 @@ Some differences:
 
 *   `tree` ([`Node`][node])
     — tree to transform (typically [`Program`][program])
-*   `options` ([`Options`][options], optional)
+*   `options` ([`Options`][api-options], optional)
     — configuration
 
 ###### Returns
@@ -165,7 +165,7 @@ Configuration (TypeScript type).
 
 ###### `runtime`
 
-Choose the [runtime][jsx-runtime] ([`Runtime`][runtime], default: `'classic'`).
+Choose the [runtime][jsx-runtime] ([`Runtime`][api-runtime], default: `'classic'`).
 
 Comment form: `@jsxRuntime theRuntime`.
 
@@ -249,14 +249,18 @@ tree.comments = comments
 ## Types
 
 This package is fully typed with [TypeScript][].
-It exports the additional type [`Options`][options] and [`Runtime`][runtime].
+It exports the additional type [`Options`][api-options] and
+[`Runtime`][api-runtime].
 
 ## 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, `estree-util-build-jsx@^2`,
+compatible with Node.js 12.
 
 ## Related
 
@@ -298,9 +302,9 @@ abide by its terms.
 
 [downloads]: https://www.npmjs.com/package/estree-util-build-jsx
 
-[size-badge]: https://img.shields.io/bundlephobia/minzip/estree-util-build-jsx.svg
+[size-badge]: https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=estree-util-build-jsx
 
-[size]: https://bundlephobia.com/result?p=estree-util-build-jsx
+[size]: https://bundlejs.com/?q=estree-util-build-jsx
 
 [sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg
 
@@ -346,8 +350,8 @@ abide by its terms.
 
 [esbuild]: https://esbuild.github.io
 
-[build-jsx]: #buildjsxtree-options
+[api-build-jsx]: #buildjsxtree-options
 
-[options]: #options
+[api-options]: #options
 
-[runtime]: #runtime-1
+[api-runtime]: #runtime-1