ref: Update docs

2 files changed, 5 insertions, 1 deletions

diff --git a/ref/doc.go b/ref/doc.go
new file mode 100644
index 00000000..610c3013
--- /dev/null
+++ b/ref/doc.go
@@ -0,0 +1,5 @@
+// Package ref provides Git reference values.
+//
+// A reference is either [Detached], which points directly to an object ID, or
+// [Symbolic], which points to another reference name.
+package ref
diff --git a/ref/ref.go b/ref/ref.go
index 51f4d764..0c70cc26 100644
--- a/ref/ref.go
+++ b/ref/ref.go
@@ -1,4 +1,3 @@
-// Package ref provides general, detached, and symbolic references.
 package ref
 
 // Ref is a Git reference.