1 files changed, 6 insertions, 1 deletions
diff --git a/ref/name/doc.go b/ref/name/doc.go
index 363733f3..48d06aac 100644
--- a/ref/name/doc.go
+++ b/ref/name/doc.go
@@ -1,2 +1,7 @@
-// Package refname provides various routines to check and normalize reference names.
+// Package refname provides Git reference-name validation, normalization, and
+// classification helpers.
+//
+// It includes branch and tag abbreviation expansion, worktree-qualified refs,
+// update validation, and the distinction between ordinary refs, root refs,
+// pseudo-refs, and filesystem-safe names.
 package refname