Refactor docs

Author: wooorm

readme.md

@@ -69,7 +69,7 @@ internals away.
 ## 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 mdast-util-frontmatter
@@ -105,10 +105,10 @@ title = "New Website"
 
 ```js
 import fs from 'node:fs/promises'
-import {fromMarkdown} from 'mdast-util-from-markdown'
-import {toMarkdown} from 'mdast-util-to-markdown'
 import {frontmatter} from 'micromark-extension-frontmatter'
+import {fromMarkdown} from 'mdast-util-from-markdown'
 import {frontmatterFromMarkdown, frontmatterToMarkdown} from 'mdast-util-frontmatter'
+import {toMarkdown} from 'mdast-util-to-markdown'
 
 const doc = await fs.readFile('example.md')
 
@@ -151,8 +151,8 @@ title = "New Website"
 ## API
 
 This package exports the identifiers
-[`frontmatterFromMarkdown`][api-frontmatterfrommarkdown] and
-[`frontmatterToMarkdown`][api-frontmattertomarkdown].
+[`frontmatterFromMarkdown`][api-frontmatter-from-markdown] and
+[`frontmatterToMarkdown`][api-frontmatter-to-markdown].
 There is no default export.
 
 ### `frontmatterFromMarkdown(options?)`
@@ -168,7 +168,7 @@ Create an extension for
 ###### Returns
 
 Extension for `mdast-util-from-markdown`
-([`FromMarkdownExtension`][frommarkdownextension]).
+([`FromMarkdownExtension`][from-markdown-extension]).
 
 ### `frontmatterToMarkdown(options?)`
 
@@ -183,27 +183,25 @@ Create an extension for
 ###### Returns
 
 Extension for `mdast-util-to-markdown`
-([`ToMarkdownExtension`][tomarkdownextension]).
+([`ToMarkdownExtension`][to-markdown-extension]).
 
 ### `Info`
 
 Structure of marker or fence (TypeScript type).
 
-<!-- To do: fix link when `info` is documented -->
-
-Same as [`Info` from `micromark-extension-frontmatter`][matter].
+Same as [`Info` from `micromark-extension-frontmatter`][micromark-info].
 
 ### `Matter`
 
 Structure of matter (TypeScript type).
 
-Same as [`Matter` from `micromark-extension-frontmatter`][matter].
+Same as [`Matter` from `micromark-extension-frontmatter`][micromark-matter].
 
 ### `Options`
 
 Configuration (TypeScript type).
 
-Same as [`Options` from `micromark-extension-frontmatter`][options].
+Same as [`Options` from `micromark-extension-frontmatter`][micromark-options].
 
 ## Syntax
 
@@ -293,12 +291,15 @@ declare module 'mdast' {
 
 ## 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.
 
-These extensions works with `mdast-util-from-markdown` version 1+ and
+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,
+`mdast-util-frontmatter@^1`, compatible with Node.js 12.
+
+This utility works with `mdast-util-from-markdown` version 1+ and
 `mdast-util-to-markdown` version 1+.
 
 ## Related
@@ -336,9 +337,9 @@ abide by its terms.
 
 [downloads]: https://www.npmjs.com/package/mdast-util-frontmatter
 
-[size-badge]: https://img.shields.io/bundlephobia/minzip/mdast-util-frontmatter.svg
+[size-badge]: https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=mdast-util-frontmatter
 
-[size]: https://bundlephobia.com/result?p=mdast-util-frontmatter
+[size]: https://bundlejs.com/?q=mdast-util-frontmatter
 
 [sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg
 
@@ -382,9 +383,11 @@ abide by its terms.
 
 [micromark-extension-frontmatter]: https://github.com/micromark/micromark-extension-frontmatter
 
-[options]: https://github.com/micromark/micromark-extension-frontmatter#options
+[micromark-info]: https://github.com/micromark/micromark-extension-frontmatter#info
+
+[micromark-matter]: https://github.com/micromark/micromark-extension-frontmatter#matter
 
-[matter]: https://github.com/micromark/micromark-extension-frontmatter#matter
+[micromark-options]: https://github.com/micromark/micromark-extension-frontmatter#options
 
 [syntax]: https://github.com/micromark/micromark-extension-frontmatter#syntax
 
@@ -394,15 +397,15 @@ abide by its terms.
 
 [term-head]: https://github.com/syntax-tree/unist#head
 
-[frommarkdownextension]: https://github.com/syntax-tree/mdast-util-from-markdown#extension
+[from-markdown-extension]: https://github.com/syntax-tree/mdast-util-from-markdown#extension
 
-[tomarkdownextension]: https://github.com/syntax-tree/mdast-util-to-markdown#options
+[to-markdown-extension]: https://github.com/syntax-tree/mdast-util-to-markdown#options
 
 [dfn-frontmatter-content]: #frontmattercontent
 
-[api-frontmatterfrommarkdown]: #frontmatterfrommarkdownoptions
+[api-frontmatter-from-markdown]: #frontmatterfrommarkdownoptions
 
-[api-frontmattertomarkdown]: #frontmattertomarkdownoptions
+[api-frontmatter-to-markdown]: #frontmattertomarkdownoptions
 
 [api-info]: #info