furgit: Document interface/implementation contract docs

1 files changed, 7 insertions, 0 deletions

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