From ed2e714964f9196fcb6dbc49cbf875a8f6209165 Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Thu, 2 Apr 2026 08:02:36 +0000
Subject: furgit: Document interface/implementation contract docs

---
 doc.go | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc.go b/doc.go
index 5ff1e2d1..e0f4d08c 100644
--- a/doc.go
+++ b/doc.go
@@ -57,4 +57,11 @@
 //
 // These labels describe the API contract only,
 // and do not imply any specific implementation strategy.
+//
+// Concrete implementations of capability interfaces
+// generally inherit the contract documented by the interfaces they satisfy.
+// Implementation docs focus on additional guarantees
+// and implementation-specific behavior,
+// but users are advised not to reply on them
+// in order to maintain the flexibility of switching implementations.
 package furgit
-- 
cgit v1.3.1-10-gc9f91