Refactor docs

Author: wooorm

readme.md

@@ -45,7 +45,7 @@ It turns the tree into a string of JavaScript.
 ## 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 esast-util-from-js
@@ -117,7 +117,7 @@ Yields:
 
 ## API
 
-This package exports the identifier [`fromJs`][fromjs].
+This package exports the identifier [`fromJs`][api-from-js].
 There is no default export.
 
 ### `fromJs(value[, options])`
@@ -126,9 +126,9 @@ Parse JavaScript to an esast.
 
 ###### Parameters
 
-*   `value` ([`Value`][value])
+*   `value` ([`Value`][api-value])
     — serialized JavaScript to parse
-*   `options` ([`Options`][options], optional)
+*   `options` ([`Options`][api-options], optional)
     — configuration
 
 ###### Returns
@@ -152,7 +152,7 @@ Configuration (TypeScript type).
 
 ###### `version`
 
-JavaScript version ([`Version`][version], default: `'latest'`).
+JavaScript version ([`Version`][api-version], default: `'latest'`).
 
 When a number, must be a year in the range `2015` and `2023` (both including).
 `'latest'` is the same as passing the latest supported year.
@@ -190,7 +190,7 @@ Whether a shell hasbang is allowed (`boolean`, default: `false`).
 
 ###### `plugins`
 
-List of acorn plugins ([`Array<Plugin>`][plugin], default: `[]`).
+List of acorn plugins ([`Array<Plugin>`][api-plugin], default: `[]`).
 Examples are [`acorn-jsx`][acorn-jsx] and [`acorn-stage3`][acorn-stage3].
 
 ### `Plugin`
@@ -230,15 +230,20 @@ type Version = 2015 | 2016 | 2017 | 2018 | 2019 | 2020 | 2021 | 2022 | 2023 | 'l
 ## Types
 
 This package is fully typed with [TypeScript][].
-It exports the additional types [`Options`][options], [`Plugin`][plugin],
-[`Value`][value], and [`Version`][version].
+It exports the additional types [`Options`][api-options],
+[`Plugin`][api-plugin],
+[`Value`][api-value], and
+[`Version`][api-version].
 
 ## 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, `esast-util-from-js@^1`,
+compatible with Node.js 12.
 
 ## Contribute
 
@@ -268,9 +273,9 @@ abide by its terms.
 
 [downloads]: https://www.npmjs.com/package/esast-util-from-js
 
-[size-badge]: https://img.shields.io/bundlephobia/minzip/esast-util-from-js.svg
+[size-badge]: https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=esast-util-from-js
 
-[size]: https://bundlephobia.com/result?p=esast-util-from-js
+[size]: https://bundlejs.com/?q=esast-util-from-js
 
 [sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg
 
@@ -322,12 +327,12 @@ abide by its terms.
 
 [vfile-message]: https://github.com/vfile/vfile-message
 
-[fromjs]: #fromjsvalue-options
+[api-from-js]: #fromjsvalue-options
 
-[options]: #options
+[api-options]: #options
 
-[plugin]: #plugin
+[api-plugin]: #plugin
 
-[value]: #value
+[api-value]: #value
 
-[version]: #version-1
+[api-version]: #version-1