From 161d2fab0b7ddee35696c5600d3ebd5bae6e6527 Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Sun, 29 Mar 2026 08:09:34 +0000
Subject: repository: Add guidance

---
 repository/objects.go | 4 ++++
 1 file changed, 4 insertions(+)

(limited to 'repository/objects.go')

diff --git a/repository/objects.go b/repository/objects.go
index ea1956c1..62170514 100644
--- a/repository/objects.go
+++ b/repository/objects.go
@@ -77,6 +77,10 @@ func openObjectStore(
 
 // Objects returns the configured object store.
 //
+// Use Objects for direct object-ID lookups, object headers, sizes, raw object
+// bytes, or streamed object contents. Callers who want typed object values
+// should usually prefer [Repository.Fetcher].
+//
 // Labels: Life-Parent, Close-No.
 //
 //nolint:ireturn
-- 
cgit v1.3.1-10-gc9f91