slowly improving doc generation

Author: allmightyspiff

docs/main.go

@@ -82,6 +82,9 @@ func CliDocs() {
 		}
 		if len(iCmd.Commands()) > 0 {
 			thisCmdGroup.Commands = buildSlCmdDoc(iCmd)
+		} else {
+			// This is a single command, like 'call-api' and doesn't have sub-commands
+			thisCmdGroup.Commands = []SlCmdDoc{cobraToSl(iCmd, "")}
 		}
 		PrintMakrdown(thisCmdGroup)
 		CmdGroups = append(CmdGroups, thisCmdGroup)
@@ -96,11 +99,6 @@ func CliDocs() {
 func PrintMakrdown(cmd SlCmdGroup) {
 
 	var cmdTemplate = `<!-- THIS FILE IS AUTOMATICALLY GENERATED, DO NOT EDIT -->
-# ibmcloud sl {{.Name}}
-{: #{{.CommandShortLink}}}
-
-{{.Help}}
-
 {{range .Commands}}
 ## ibmcloud {{.CommandPath}}
 {: #{{.CommandShortLink}}}
@@ -140,27 +138,34 @@ func getLongHelp(helpString string) string {
 func buildSlCmdDoc(topCommand *cobra.Command) []SlCmdDoc {
 	docs := []SlCmdDoc{}
 	for _, iCmd := range topCommand.Commands() {
-		shortName := fmt.Sprintf("sl_%s_%s", topCommand.Name(), iCmd.Name())
-		shortName = strings.ReplaceAll(shortName, " ", "_")
-		shortName = strings.ReplaceAll(shortName, "-", "_")
-		longHelp := getLongHelp(iCmd.Long)
-		thisDoc := SlCmdDoc{
-			Name: iCmd.Name(),
-			CommandShortLink: shortName,
-			CommandPath: iCmd.CommandPath(),
-			Use: iCmd.UseLine(),
-			Flags: nil,
-			Help: iCmd.Short,
-			LongHelp: longHelp,
-			Backtick:  "```",
-		}
-		thisDoc.Flags = buildSlCmdFlag(iCmd)
-
+		thisDoc := cobraToSl(iCmd, topCommand.Name())
 		docs = append(docs, thisDoc)
 	}
 	return docs
 }
 
+func cobraToSl(iCmd *cobra.Command, tlcmd string) SlCmdDoc {
+
+	shortName := fmt.Sprintf("sl_%s_%s", tlcmd, iCmd.Name())
+	shortName = strings.ReplaceAll(shortName, " ", "_")
+	shortName = strings.ReplaceAll(shortName, "-", "_")
+	longHelp := getLongHelp(iCmd.Long)
+	thisDoc := SlCmdDoc{
+		Name: iCmd.Name(),
+		CommandShortLink: shortName,
+		CommandPath: iCmd.CommandPath(),
+		Use: iCmd.UseLine(),
+		Flags: nil,
+		Help: iCmd.Short,
+		LongHelp: longHelp,
+		Backtick:  "```",
+	}
+	thisDoc.Flags = buildSlCmdFlag(iCmd)
+
+	return thisDoc
+
+}
+
 func buildSlCmdFlag(topCommand *cobra.Command) []SlCmdFlag {
 	flags := []SlCmdFlag{}
 	flagSet := topCommand.Flags()