Add improved docs

Author: wooorm

lib/index.js

@@ -26,7 +26,13 @@
  * @param {Node | NodeLike | Position | PositionLike | Point | PointLike | null | undefined} [value]
  *   Node, position, or point.
  * @returns {string}
- *   Positional info.
+ *   Pretty printed positional info of a node (`string`).
+ *
+ *   In the format of a range `ls:cs-le:ce` (when given `node` or `position`)
+ *   or a point `l:c` (when given `point`), where `l` stands for line, `c` for
+ *   column, `s` for `start`, and `e` for end.
+ *   An empty string (`''`) is returned if the given value is neither `node`,
+ *   `position`, nor `point`.
  */
 export function stringifyPosition(value) {
   // Nothing.

readme.md

@@ -39,7 +39,7 @@ For example, when throwing errors or warning messages about something.
 ## Install
 
 This package is [ESM only][esm].
-In Node.js (version 12.20+, 14.14+, 16.0+, or 18.0+), install with [npm][]:
+In Node.js (version 14.14+ and 16.0+), install with [npm][]:
 
 ```sh
 npm install unist-util-stringify-position
@@ -78,25 +78,27 @@ stringifyPosition({
 
 ## API
 
-This package exports the identifier `stringifyPosition`.
+This package exports the identifier [`stringifyPosition`][stringifyposition].
 There is no default export.
 
 ### `stringifyPosition(node|position|point)`
 
-Stringify a point, position, or node.
+Serialize the positional info of a point, position (start and end points), or
+node.
 
 ###### Parameters
 
 *   `node` ([`Node`][node])
-    — node whose `'position'` property to stringify
+    — node whose `position` fields to serialize
 *   `position` ([`Position`][position])
-    — position whose `'start'` and `'end'` points to stringify
+    — position whose `start` and `end` points to serialize
 *   `point` ([`Point`][point])
-    — point whose `'line'` and `'column'` to stringify
+    — point whose `line` and `column` fields to serialize
 
 ###### Returns
 
 Pretty printed positional info of a node (`string`).
+
 In the format of a range `ls:cs-le:ce` (when given `node` or `position`) or a
 point `l:c` (when given `point`), where `l` stands for line, `c` for column, `s`
 for `start`, and `e` for end.
@@ -112,7 +114,7 @@ It exports no additional types.
 
 Projects maintained by the unified collective are compatible with all maintained
 versions of Node.js.
-As of now, that is Node.js 12.20+, 14.14+, 16.0+, and 18.0+.
+As of now, that is Node.js 14.14+ and 16.0+.
 Our projects sometimes work with older versions, but this is not guaranteed.
 
 ## Security
@@ -197,3 +199,5 @@ abide by its terms.
 [position]: https://github.com/syntax-tree/unist#position
 
 [point]: https://github.com/syntax-tree/unist#point
+
+[stringifyposition]: #stringifypositionnodepositionpoint