From 85ee911bf6417a0d5bae187f9e8c2d0a4daa2201 Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Mon, 30 Mar 2026 12:28:04 +0000
Subject: object/store: Okay, I intend to have a writing interface.

---
 object/store/doc.go | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

(limited to 'object/store')

diff --git a/object/store/doc.go b/object/store/doc.go
index 4e05f59c..cf1ac27d 100644
--- a/object/store/doc.go
+++ b/object/store/doc.go
@@ -1,14 +1,15 @@
 // Package objectstore provides interfaces for object storage backends.
 //
-// Object stores only respond to object-ID queries in terms of headers (type
+// Reading stores only respond to object-ID queries in terms of headers (type
 // and size), raw bytes, and streaming payloads, but they do not parse commits,
 // trees, blobs, or tags into typed values. Turning stored objects into typed
 // objects is the job of [codeberg.org/lindenii/furgit/object/fetch].
 //
-// This package also does not define a unified writing-store interface.
-// Backends have very different write models: writing one loose object is
-// natural, while writing one object into a packfile backend is wasteful.
-// A variety of writing interfaces may be added later.
+// This package does not define one unified writing interface. Backends have
+// very different write models: writing one loose object is natural, while
+// writing one object into a packfile backend is wasteful. Instead, we define
+// distinct optional capabilities for object-wise writes, pack-wise writes,
+// and compose them against quarantined writes.
 //
 // Concrete implementations generally inherit the contract documented by the
 // interfaces they satisfy. Implementation docs focus on additional guarantees
-- 
cgit v1.3.1-10-gc9f91