Refactor prose

Author: wooorm

readme.md

@@ -1,18 +1,26 @@
-# hast-util-shift-heading [![Build][build-badge]][build] [![Coverage][coverage-badge]][coverage] [![Chat][chat-badge]][chat]
+# hast-util-shift-heading
 
-Change heading rank (or depth, level) in **[hast][]**.
+[![Build][build-badge]][build]
+[![Coverage][coverage-badge]][coverage]
+[![Downloads][downloads-badge]][downloads]
+[![Size][size-badge]][size]
+[![Sponsors][sponsors-badge]][collective]
+[![Backers][backers-badge]][collective]
+[![Chat][chat-badge]][chat]
 
-## Installation
+[**hast**][hast] utility to change the rank (depth, level) of headings.
+
+## Install
 
 [npm][]:
 
-```bash
+```sh
 npm install hast-util-shift-heading
 ```
 
 ## Usage
 
-```javascript
+```js
 var h = require('hastscript')
 var shift = require('hast-util-shift-heading')
 
@@ -79,7 +87,7 @@ or `h7`).
 
 ###### Parameters
 
-*   `tree` ([`Node`][node]) — Tree to walk
+*   `tree` ([`Node`][node]) — [*Tree*][tree] to walk
 *   `shift` (`number`) — Non-null finite integer to use to shift ranks
 
 ###### Returns
@@ -92,11 +100,13 @@ or `h7`).
 
 ## Contribute
 
-See [`contributing.md` in `syntax-tree/hast`][contributing] for ways to get
+See [`contributing.md` in `syntax-tree/.github`][contributing] for ways to get
 started.
+See [`support.md`][support] for ways to get help.
 
-This organisation has a [Code of Conduct][coc].  By interacting with this
-repository, organisation, or community you agree to abide by its terms.
+This project has a [Code of Conduct][coc].
+By interacting with this repository, organisation, or community you agree to
+abide by its terms.
 
 ## License
 
@@ -112,20 +122,38 @@ repository, organisation, or community you agree to abide by its terms.
 
 [coverage]: https://codecov.io/github/syntax-tree/hast-util-shift-heading
 
+[downloads-badge]: https://img.shields.io/npm/dm/hast-util-shift-heading.svg
+
+[downloads]: https://www.npmjs.com/package/hast-util-shift-heading
+
+[size-badge]: https://img.shields.io/bundlephobia/minzip/hast-util-shift-heading.svg
+
+[size]: https://bundlephobia.com/result?p=hast-util-shift-heading
+
+[sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg
+
+[backers-badge]: https://opencollective.com/unified/backers/badge.svg
+
+[collective]: https://opencollective.com/unified
+
 [chat-badge]: https://img.shields.io/badge/join%20the%20community-on%20spectrum-7b16ff.svg
 
-[chat]: https://spectrum.chat/unified/rehype
+[chat]: https://spectrum.chat/unified/syntax-tree
 
 [npm]: https://docs.npmjs.com/cli/install
 
 [license]: license
 
 [author]: https://wooorm.com
 
-[hast]: https://github.com/syntax-tree/hast
+[contributing]: https://github.com/syntax-tree/.github/blob/master/contributing.md
 
-[node]: https://github.com/syntax-tree/unist#node
+[support]: https://github.com/syntax-tree/.github/blob/master/support.md
 
-[contributing]: https://github.com/syntax-tree/hast/blob/master/contributing.md
+[coc]: https://github.com/syntax-tree/.github/blob/master/code-of-conduct.md
+
+[tree]: https://github.com/syntax-tree/unist#tree
+
+[hast]: https://github.com/syntax-tree/hast
 
-[coc]: https://github.com/syntax-tree/hast/blob/master/code-of-conduct.md
+[node]: https://github.com/syntax-tree/hast#nodes