From 03c05c7e86b012bc790b468732d265e1090650ff Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Sun, 29 Mar 2026 09:56:48 +0000
Subject: ref/store: Expand docs

---
 ref/store/doc.go | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/ref/store/doc.go b/ref/store/doc.go
index e022f55b..8f7f39a6 100644
--- a/ref/store/doc.go
+++ b/ref/store/doc.go
@@ -1,5 +1,13 @@
 // Package refstore provides interfaces for reference storage backends.
 //
+// Ref stores directly use reference values. Unlike object storage, they
+// do not have a separate fetch layer to parse backend results into
+// higher-level forms.
+//
+// The package separates read-only access from atomic transactions and
+// non-atomic batches. Not every readable ref backend is writable, and not
+// every writable backend necessarily offers the same update model.
+//
 // Concrete implementations generally inherit the contract documented by the
 // interfaces they satisfy. Implementation docs focus on additional guarantees
 // and implementation-specific behavior.
-- 
cgit v1.3.1-10-gc9f91