diff --git a/secret/secret.go b/secret/secret.go
index c560fa48f..5cd87a260 100644
--- a/secret/secret.go
+++ b/secret/secret.go
@@ -1,3 +1,6 @@
+// Package secret provides functionality for generating and storing secrets
+// both in a remote swarm and locally within supported storage such as pass
+// stores.
 package secret
 
 import (