diff --git a/alldocs.go b/alldocs.go
index 32da424..682c721 100644
--- a/alldocs.go
+++ b/alldocs.go
@@ -2,7 +2,7 @@
 //go:generate gvt help documentation
 
 /*
-gvt, a tool to manage your vendored dependencies.
+gvt, a simple go vendoring tool based on gb-vendor.
 
 Usage:
         gvt command [arguments]
@@ -11,13 +11,13 @@
 
         fetch       fetch a remote dependency
         update      update a local dependency
-        list        lists dependencies, one per line
+        list        list dependencies, one per line
         delete      delete a local dependency
 
 Use "gvt help [command]" for more information about a command.
 
 
-## Fetch a remote dependency
+Fetch a remote dependency
 
 Usage:
         gvt fetch [-branch branch | -revision rev | -tag tag] [-precaire] [-no-recurse] importpath
@@ -42,7 +42,7 @@
 	-precaire
 		allow the use of insecure protocols.
 
-## Update a local dependency
+Update a local dependency
 
 Usage:
         gvt update [-all] import
@@ -63,21 +63,19 @@
 	-precaire
 		allow the use of insecure protocols.
 
-## Lists dependencies, one per line
+List dependencies, one per line
 
 Usage:
         gvt list [-f format]
 
 list formats the contents of the manifest file.
 
-The output
-
 Flags:
 	-f
 		controls the template used for printing each manifest entry. If not supplied
 		the default value is "{{.Importpath}}\t{{.Repository}}{{.Path}}\t{{.Branch}}\t{{.Revision}}"
 
-## Delete a local dependency
+Delete a local dependency
 
 Usage:
         gvt delete [-all] importpath
diff --git a/help.go b/help.go
index a0c8856..f99dbca 100644
--- a/help.go
+++ b/help.go
@@ -76,7 +76,7 @@
 /*
 {{ .Usage }}
 
-{{range .Commands}}{{if .Short}}## {{.Short | capitalize}}
+{{range .Commands}}{{if .Short}}{{.Short | capitalize}}
 {{end}}
 Usage:
         gvt {{.UsageLine}}
diff --git a/list.go b/list.go
index e3113d9..64917f1 100644
--- a/list.go
+++ b/list.go
@@ -21,11 +21,9 @@
 var cmdList = &Command{
 	Name:      "list",
 	UsageLine: "list [-f format]",
-	Short:     "lists dependencies, one per line",
+	Short:     "list dependencies, one per line",
 	Long: `list formats the contents of the manifest file.
 
-The output
-
 Flags:
 	-f
 		controls the template used for printing each manifest entry. If not supplied