From d4c4ccd763a65518dfcc7b486808b0b6460b79be Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Sat, 28 Mar 2026 15:52:51 +0000
Subject: object/store: Document writing interface lack

---
 object/store/doc.go     | 8 --------
 object/store/writing.go | 9 +++++++++
 2 files changed, 9 insertions(+), 8 deletions(-)
 create mode 100644 object/store/writing.go

diff --git a/object/store/doc.go b/object/store/doc.go
index 24124c10..943dbea4 100644
--- a/object/store/doc.go
+++ b/object/store/doc.go
@@ -3,12 +3,4 @@
 // Concrete implementations generally inherit the contract documented by the
 // interfaces they satisfy. Implementation docs focus on additional guarantees
 // and implementation-specific behavior.
-//
-// There is currently no writing-store interface because different
-// object store backends have very different models for writing.
-// For example, a loose object store can trivially write single loose
-// objects, but writing individual objects to a packfile store would
-// be extremely wasteful.
-//
-// At some time, we will have writing-store interfaces.
 package objectstore
diff --git a/object/store/writing.go b/object/store/writing.go
new file mode 100644
index 00000000..e673f6eb
--- /dev/null
+++ b/object/store/writing.go
@@ -0,0 +1,9 @@
+package objectstore
+
+// There is currently no writing-store interface because different
+// object store backends have very different models for writing.
+// For example, a loose object store can trivially write single loose
+// objects, but writing individual objects to a packfile store would
+// be extremely wasteful.
+//
+// At some time, we will have writing-store interfaces.
-- 
cgit v1.3.1-10-gc9f91