doc: create maintaining-brotli.md

PR-URL: #47380 Refs: nodejs/security-wg#828 Reviewed-By: Yagiz Nizipli <[email protected]> Reviewed-By: Paolo Insogna <[email protected]> Reviewed-By: Rafael Gonzaga <[email protected]> Reviewed-By: Luigi Pinca <[email protected]>
nodejs · May 2, 2023 · 537c17e · 537c17e
1 parent cda36bf
commit 537c17e
Showing 1 changed file with 26 additions and 0 deletions.
diff --git a/doc/contributing/maintaining-brotli.md b/doc/contributing/maintaining-brotli.md
@@ -0,0 +1,26 @@
+# Maintaining brotli
+
+The [brotli](https://github.com/google/brotli) dependency is used for 
+the homonym generic-purpose lossless compression algorithm.
+
+## Updating brotli
+
+The `tools/dep_updaters/update-brotli.sh` script automates the update of the
+brotli source files.
+
+Check that Node.js still builds and tests.
+
+## Committing postject
+
+1. Add brotli:
+   ```console
+   $ git add deps/brotli
+   ```
+2. Commit the changes: `git commit`.
+3. Add a message like:
+
+   ```text
+   deps,test: update brotli to <version>
+
+   Updated as described in doc/contributing/maintaining-brotli.md.
+   ```