From f0df94f08549b5de5cb9311e1041473904b54661 Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Mon, 30 Mar 2026 15:48:35 +0000
Subject: object/store: Clarify quarantine docs

---
 object/store/quarantine.go | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/object/store/quarantine.go b/object/store/quarantine.go
index 7f538f43..a9ba4f55 100644
--- a/object/store/quarantine.go
+++ b/object/store/quarantine.go
@@ -2,12 +2,16 @@ package objectstore
 
 // Quarantine is one quarantined write. It is intended to be embedded.
 type Quarantine interface {
-	// Reader returns the objects written into this quarantine.
+	// Reader exposes the objects written into this quarantine.
 	Reader
 
 	// Promote publishes quarantined writes into their final destination.
+	//
+	// Promote invalidates the receiver.
 	Promote() error
 
 	// Discard abandons quarantined writes.
+	//
+	// Discard invalidates the receiver.
 	Discard() error
 }
-- 
cgit v1.3.1-10-gc9f91