refactor: docgen subcommand rename and description

Signed-off-by: Thulio Ferraz Assis <3149049+f0rmiga@users.noreply.github.com>

cmd/docgen/main.go

@@ -23,18 +23,20 @@ func main() {
 
 	aspectRootCmd := root.NewDefaultRootCmd(pluginSystem)
 
-	cmd.AddCommand(NewCommandListCmd(aspectRootCmd))
+	cmd.AddCommand(NewBzlCommandListCmd(aspectRootCmd))
 	cmd.AddCommand(NewGenMarkdownCmd(aspectRootCmd))
 
 	if err := cmd.Execute(); err != nil {
 		log.Fatal(err)
 	}
 }
 
-func NewCommandListCmd(aspectRootCmd *cobra.Command) *cobra.Command {
+func NewBzlCommandListCmd(aspectRootCmd *cobra.Command) *cobra.Command {
 	cmd := &cobra.Command{
-		Use:   "command-list",
-		Short: "Creates a .bzl file with the top-level list of commands of the aspect CLI.",
+		Use:   "bzl-command-list",
+		Short: "Prints a .bzl file with the top-level list of commands of the aspect CLI.",
+		Long: "This command is used to produce the .bzl file with the list of top-level commands" +
+			"used to automatically generate markdown documentation for this repository.",
 		RunE: func(_ *cobra.Command, _ []string) (exitErr error) {
 			fmt.Println(`"""Generated file - do NOT edit!`)
 			fmt.Println("This module contains the list of top-level commands from the aspect CLI.")

docs/BUILD.bazel

@@ -10,7 +10,7 @@ _DOCS = ["aspect.md"] + [
 genrule(
     name = "command_list_bzl",
     outs = ["command_list.bzl"],
-    cmd = "$(execpath //cmd/docgen) command-list > $@",
+    cmd = "$(execpath //cmd/docgen) bzl-command-list > $@",
     tools = ["//cmd/docgen"],
 )