From 83b49df1d765e77d024f706ce3f0a81dd0cb9045 Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Sat, 21 Feb 2026 02:28:12 +0800
Subject: refstore: Add documentation on declared Store methods

---
 refstore/refstore.go | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/refstore/refstore.go b/refstore/refstore.go
index 08f00f17..24e75115 100644
--- a/refstore/refstore.go
+++ b/refstore/refstore.go
@@ -12,8 +12,20 @@ var ErrReferenceNotFound = errors.New("refstore: reference not found")
 
 // Store reads Git references.
 type Store interface {
+	// Resolve resolves a reference name to either a symbolic or detached ref.
+	// If the reference does not exist, implementations should return
+	// ErrReferenceNotFound.
 	Resolve(name string) (ref.Ref, error)
+	// ResolveFully resolves a reference name to a detached object ID.
+	//
+	// Implementations may use backend-local lookup semantics for symbolic hops.
+	// Callers that need cross-backend symbolic resolution (for example in a
+	// chain of stores) should prefer repeatedly calling Resolve.
 	ResolveFully(name string) (ref.Detached, error)
+	// List returns references matching pattern.
+	//
+	// The exact pattern language is backend-defined.
 	List(pattern string) ([]ref.Ref, error)
+	// Close releases resources associated with the store.
 	Close() error
 }
-- 
cgit v1.3.1-10-gc9f91