object/store: Document writing interface lack

1 files changed, 9 insertions, 0 deletions

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.