From 3fd440bc7f0ecc2bbb23a3bf6e4d271d058f9cc2 Mon Sep 17 00:00:00 2001
From: Dami Oyeniyi <damilolaoyeniyi13@gmail.com>
Date: Tue, 5 May 2026 14:02:36 +0100
Subject: [PATCH] docs: clarify default catalog protocol behavior (#11381)

---
 catalogs/protocol-parser/README.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/catalogs/protocol-parser/README.md b/catalogs/protocol-parser/README.md
index 3974dee630..9f57066f37 100644
--- a/catalogs/protocol-parser/README.md
+++ b/catalogs/protocol-parser/README.md
@@ -1,3 +1,10 @@
 # @pnpm/catalogs.protocol-parser
 
 > Parse catalog protocol specifiers and return the catalog name.
+
+Catalog protocol specifiers start with `catalog:`. The parser reads the value after that prefix as the catalog name, and returns `default` when no name is provided.
+
+## Examples
+
+- `catalog:foo` -> `"foo"`
+- `catalog:` -> `"default"`