diff --git a/core/commands2/diag.go b/core/commands2/diag.go
index e5023778d..9be4eb8d5 100644
--- a/core/commands2/diag.go
+++ b/core/commands2/diag.go
@@ -28,6 +28,10 @@ type DiagnosticOutput struct {
 }
 
 var diagCmd = &cmds.Command{
+	Help: `ipfs diag - Generate diagnostic reports.
+
+    ipfs diag net                     - Generate a network diagnostic report.
+	`,
 	Subcommands: map[string]*cmds.Command{
 		"net": diagNetCmd,
 	},
@@ -36,7 +40,7 @@ var diagCmd = &cmds.Command{
 var diagNetCmd = &cmds.Command{
 	// TODO UsageLine: "net-diag",
 	// TODO Short:     "Generate a diagnostics report",
-	Help: `ipfs diag net - Generate a diagnostics report.
+	Help: `ipfs diag net - Generate a network diagnostics report.
 
 	Sends out a message to each node in the network recursively
 	requesting a listing of data about them including number of