diff --git a/core/commands/commands.go b/core/commands/commands.go
index 8b7080493..1d65cdbad 100644
--- a/core/commands/commands.go
+++ b/core/commands/commands.go
@@ -1,3 +1,10 @@
+/*
+Package commands implements the IPFS command interface
+
+Using github.com/ipfs/go-ipfs/commands to define the command line and
+HTTP APIs.  This is the interface available to folks consuming IPFS
+from outside of the Go language.
+*/
 package commands
 
 import (