more

catalog/doc.go

@@ -34,8 +34,9 @@
 //     issues a "lookup this SKU" RPC today and resolving it here would be
 //     premature.
 //
-// See docs/published-document-vocabulary-pass.md §11 for the wider vocabulary
-// context (this package implements the cart side of that contract; the full
-// vocabulary is the next pass and lives in `platform/published` once proven
-// out).
+// This package implements the catalog side of the shared vocabulary used by
+// `platform/event` + `platform/inventory` + `platform/order`. A generic
+// `platform/node` aggregate is deliberately held back (see docs/status.md
+// "Deliberately deferred"); cross-module boundaries are served by
+// `platform/catalog` + `platform/projection` instead.
 package catalog