docs: "when should i use this?"

Signed-off-by: Lexus Drumgold <[email protected]>

Author: unicornware

.dictionary.txt

@@ -27,6 +27,7 @@ larsgw
 lcov
 micnncim
 mkbuild
+mlly
 nocheck
 npmrc
 nums

README.md

@@ -7,7 +7,7 @@
 [![vitest](https://img.shields.io/badge/-vitest-6e9f18?style=flat&logo=vitest&logoColor=ffffff)](https://vitest.dev/)
 [![yarn](https://img.shields.io/badge/-yarn-2c8ebb?style=flat&logo=yarn&logoColor=ffffff)](https://yarnpkg.com/)
 
-Utilities for creating [Node.js errors][1]
+Create [Node.js errors][1]
 
 ## Contents
 
@@ -21,15 +21,21 @@ Utilities for creating [Node.js errors][1]
 
 ## What is this?
 
-This package provides utilities for creating [Node.js errors][1].
+This package provides an API for creating [Node.js errors][1].
 
 ## When should I use this?
 
-**TODO**: Update documentation.
+This package is designed to help developers build [ponyfills][2] and utilities like [`mlly`][3] by providing a universal
+API for creating [Node.js errors][1].
+
+### Differences between Node.js
+
+- **Does not capture larger stack traces**: The Node.js API temporarily overrides [`Error.stackTraceLimit`][4] to
+  [capture larger stack traces][5]. This is **not** implemented to maintain browser compatibility.
 
 ## Install
 
-This package is [ESM only][2].
+This package is [ESM only][6].
 
 ```sh
 yarn add @flex-development/errnode
@@ -58,12 +64,16 @@ yarn add @flex-development/errnode@flex-development/errnode
 
 ## Types
 
-This package is fully typed with [TypeScript][3].
+This package is fully typed with [TypeScript][7].
 
 ## Contribute
 
 See [`CONTRIBUTING.md`](CONTRIBUTING.md).
 
 [1]: https://nodejs.org/api/errors.html#nodejs-error-codes
-[2]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
-[3]: https://www.typescriptlang.org
+[2]: https://github.com/sindresorhus/ponyfill
+[3]: https://github.com/flex-development/mlly
+[4]: https://nodejs.org/api/errors.html#errorstacktracelimit
+[5]: https://github.com/nodejs/node/blob/v19.3.0/lib/internal/errors.js#L484-L496
+[6]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+[7]: https://www.typescriptlang.org