*: Update docs v0.1.151

3 files changed, 18 insertions, 3 deletions

diff --git a/object/commit/commit.go b/object/commit/commit.go
index df0e0aca..0f7649e1 100644
--- a/object/commit/commit.go
+++ b/object/commit/commit.go
@@ -1,4 +1,9 @@
-// Package commit provides representations, parsers, and serializers for commit objects.
+// Package commit provides parsed commit objects and commit serialization.
+//
+// It parses commits into ordinary Go values for reading and construction. It
+// does not preserve the exact original byte layout needed for signature
+// verification; callers that need signature-verification payload fidelity
+// should use [codeberg.org/lindenii/furgit/object/signed/commit].
 package commit
 
 import (
diff --git a/object/signed/doc.go b/object/signed/doc.go
index 9953a3d3..fb6fc3f8 100644
--- a/object/signed/doc.go
+++ b/object/signed/doc.go
@@ -1,2 +1,7 @@
-// Package signed encapsulates some routines to process signed commits and tags.
+// Package signed encapsulates raw signed-object processing.
+//
+// Its subpackages extract verification payloads and embedded signatures from
+// raw commit and tag object bodies, without depending on the parsed
+// object models in [codeberg.org/lindenii/furgit/object/commit] and
+// [codeberg.org/lindenii/furgit/object/tag].
 package signed
diff --git a/object/tag/tag.go b/object/tag/tag.go
index 60c3a67a..e01f8ac9 100644
--- a/object/tag/tag.go
+++ b/object/tag/tag.go
@@ -1,4 +1,9 @@
-// Package tag provides representations, parsers, and serializers for tag objects.
+// Package tag provides parsed annotated tag objects and tag serialization.
+//
+// It parses annotated tags into ordinary Go values for reading and
+// construction. It does not preserve the exact original byte layout needed for
+// signature verification; callers that need signature-verification payload
+// fidelity should use [codeberg.org/lindenii/furgit/object/signed/tag].
 package tag
 
 import (