chore: disable auto generated tag for CLI docs (#5905)

kylecarbs · web-flow · commit eaf1b95e7070 · 2023-01-29T12:58:12.000-06:00
This was causing `make gen` to fail as the days went on!
diff --git a/docs/cli/coder.md b/docs/cli/coder.md
@@ -68,5 +68,3 @@ coder [flags]
 - [coder update](coder_update.md) - Update a workspace
 - [coder users](coder_users.md) - Manage users
 - [coder version](coder_version.md) - Show coder version
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_config-ssh.md b/docs/cli/coder_config-ssh.md
@@ -54,5 +54,3 @@ coder config-ssh [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_create.md b/docs/cli/coder_create.md
@@ -45,5 +45,3 @@ coder create [name] [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_delete.md b/docs/cli/coder_delete.md
@@ -37,5 +37,3 @@ coder delete <workspace> [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_dotfiles.md b/docs/cli/coder_dotfiles.md
@@ -45,5 +45,3 @@ coder dotfiles [git_repo_url] [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_list.md b/docs/cli/coder_list.md
@@ -37,5 +37,3 @@ coder list [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_login.md b/docs/cli/coder_login.md
@@ -42,5 +42,3 @@ coder login <url> [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_logout.md b/docs/cli/coder_logout.md
@@ -35,5 +35,3 @@ coder logout [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_port-forward.md b/docs/cli/coder_port-forward.md
@@ -60,5 +60,3 @@ coder port-forward <workspace> [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_publickey.md b/docs/cli/coder_publickey.md
@@ -36,5 +36,3 @@ coder publickey [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_rename.md b/docs/cli/coder_rename.md
@@ -35,5 +35,3 @@ coder rename <workspace> <new name> [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_reset-password.md b/docs/cli/coder_reset-password.md
@@ -36,5 +36,3 @@ coder reset-password <username> [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_restart.md b/docs/cli/coder_restart.md
@@ -35,5 +35,3 @@ coder restart <workspace> [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_scaletest.md b/docs/cli/coder_scaletest.md
@@ -40,5 +40,3 @@ coder scaletest [flags]
 - [coder](coder.md) -
 - [coder scaletest cleanup](coder_scaletest_cleanup.md) - Cleanup any orphaned scaletest resources
 - [coder scaletest create-workspaces](coder_scaletest_create-workspaces.md) - Creates many workspaces and waits for them to be ready
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_scaletest_cleanup.md b/docs/cli/coder_scaletest_cleanup.md
@@ -44,5 +44,3 @@ coder scaletest cleanup [flags]
 ### SEE ALSO
 
 - [coder scaletest](coder_scaletest.md) - Run a scale test against the Coder API
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_scaletest_create-workspaces.md b/docs/cli/coder_scaletest_create-workspaces.md
@@ -96,5 +96,3 @@ coder scaletest create-workspaces [flags]
 ### SEE ALSO
 
 - [coder scaletest](coder_scaletest.md) - Run a scale test against the Coder API
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_schedule.md b/docs/cli/coder_schedule.md
@@ -38,5 +38,3 @@ coder schedule { show | start | stop | override } <workspace> [flags]
 - [coder schedule show](coder_schedule_show.md) - Show workspace schedule
 - [coder schedule start](coder_schedule_start.md) - Edit workspace start schedule
 - [coder schedule stop](coder_schedule_stop.md) - Edit workspace stop schedule
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_schedule_override-stop.md b/docs/cli/coder_schedule_override-stop.md
@@ -48,5 +48,3 @@ coder schedule override-stop <workspace-name> <duration from now> [flags]
 ### SEE ALSO
 
 - [coder schedule](coder_schedule.md) - Schedule automated start and stop times for workspaces
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_schedule_show.md b/docs/cli/coder_schedule_show.md
@@ -43,5 +43,3 @@ coder schedule show <workspace-name> [flags]
 ### SEE ALSO
 
 - [coder schedule](coder_schedule.md) - Schedule automated start and stop times for workspaces
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_schedule_start.md b/docs/cli/coder_schedule_start.md
@@ -55,5 +55,3 @@ coder schedule start <workspace-name> { <start-time> [day-of-week] [location] |
 ### SEE ALSO
 
 - [coder schedule](coder_schedule.md) - Schedule automated start and stop times for workspaces
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_schedule_stop.md b/docs/cli/coder_schedule_stop.md
@@ -57,5 +57,3 @@ coder schedule stop <workspace-name> { <duration> | manual } [flags]
 ### SEE ALSO
 
 - [coder schedule](coder_schedule.md) - Schedule automated start and stop times for workspaces
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_server.md b/docs/cli/coder_server.md
@@ -168,5 +168,3 @@ coder server [flags]
 - [coder](coder.md) -
 - [coder server postgres-builtin-serve](coder_server_postgres-builtin-serve.md) - Run the built-in PostgreSQL deployment.
 - [coder server postgres-builtin-url](coder_server_postgres-builtin-url.md) - Output the connection URL for the built-in PostgreSQL deployment.
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_server_postgres-builtin-serve.md b/docs/cli/coder_server_postgres-builtin-serve.md
@@ -35,5 +35,3 @@ coder server postgres-builtin-serve [flags]
 ### SEE ALSO
 
 - [coder server](coder_server.md) - Start a Coder server
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_server_postgres-builtin-url.md b/docs/cli/coder_server_postgres-builtin-url.md
@@ -35,5 +35,3 @@ coder server postgres-builtin-url [flags]
 ### SEE ALSO
 
 - [coder server](coder_server.md) - Start a Coder server
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_show.md b/docs/cli/coder_show.md
@@ -34,5 +34,3 @@ coder show <workspace> [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_speedtest.md b/docs/cli/coder_speedtest.md
@@ -37,5 +37,3 @@ coder speedtest <workspace> [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_ssh.md b/docs/cli/coder_ssh.md
@@ -46,5 +46,3 @@ coder ssh <workspace> [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_start.md b/docs/cli/coder_start.md
@@ -35,5 +35,3 @@ coder start <workspace> [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_state.md b/docs/cli/coder_state.md
@@ -36,5 +36,3 @@ coder state [flags]
 - [coder](coder.md) -
 - [coder state pull](coder_state_pull.md) -
 - [coder state push](coder_state_push.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_state_pull.md b/docs/cli/coder_state_pull.md
@@ -33,5 +33,3 @@ coder state pull <workspace> [file] [flags]
 ### SEE ALSO
 
 - [coder state](coder_state.md) - Manually manage Terraform state to fix broken workspaces
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_state_push.md b/docs/cli/coder_state_push.md
@@ -33,5 +33,3 @@ coder state push <workspace> <file> [flags]
 ### SEE ALSO
 
 - [coder state](coder_state.md) - Manually manage Terraform state to fix broken workspaces
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_stop.md b/docs/cli/coder_stop.md
@@ -35,5 +35,3 @@ coder stop <workspace> [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_templates.md b/docs/cli/coder_templates.md
@@ -63,5 +63,3 @@ coder templates [flags]
 - [coder templates pull](coder_templates_pull.md) - Download the latest version of a template to a path.
 - [coder templates push](coder_templates_push.md) - Push a new template version from the current directory or as specified by flag
 - [coder templates versions](coder_templates_versions.md) - Manage different versions of the specified template
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_templates_create.md b/docs/cli/coder_templates_create.md
@@ -39,5 +39,3 @@ coder templates create [name] [flags]
 ### SEE ALSO
 
 - [coder templates](coder_templates.md) - Manage templates
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_templates_delete.md b/docs/cli/coder_templates_delete.md
@@ -35,5 +35,3 @@ coder templates delete [name...] [flags]
 ### SEE ALSO
 
 - [coder templates](coder_templates.md) - Manage templates
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_templates_edit.md b/docs/cli/coder_templates_edit.md
@@ -41,5 +41,3 @@ coder templates edit <template> [flags]
 ### SEE ALSO
 
 - [coder templates](coder_templates.md) - Manage templates
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_templates_init.md b/docs/cli/coder_templates_init.md
@@ -34,5 +34,3 @@ coder templates init [directory] [flags]
 ### SEE ALSO
 
 - [coder templates](coder_templates.md) - Manage templates
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_templates_list.md b/docs/cli/coder_templates_list.md
@@ -35,5 +35,3 @@ coder templates list [flags]
 ### SEE ALSO
 
 - [coder templates](coder_templates.md) - Manage templates
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_templates_plan.md b/docs/cli/coder_templates_plan.md
@@ -34,5 +34,3 @@ coder templates plan <directory> [flags]
 ### SEE ALSO
 
 - [coder templates](coder_templates.md) - Manage templates
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_templates_pull.md b/docs/cli/coder_templates_pull.md
@@ -35,5 +35,3 @@ coder templates pull <name> [destination] [flags]
 ### SEE ALSO
 
 - [coder templates](coder_templates.md) - Manage templates
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_templates_push.md b/docs/cli/coder_templates_push.md
@@ -40,5 +40,3 @@ coder templates push [template] [flags]
 ### SEE ALSO
 
 - [coder templates](coder_templates.md) - Manage templates
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_templates_versions.md b/docs/cli/coder_templates_versions.md
@@ -43,5 +43,3 @@ coder templates versions [flags]
 
 - [coder templates](coder_templates.md) - Manage templates
 - [coder templates versions list](coder_templates_versions_list.md) - List all the versions of the specified template
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_templates_versions_list.md b/docs/cli/coder_templates_versions_list.md
@@ -34,5 +34,3 @@ coder templates versions list <template> [flags]
 ### SEE ALSO
 
 - [coder templates versions](coder_templates_versions.md) - Manage different versions of the specified template
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_tokens.md b/docs/cli/coder_tokens.md
@@ -57,5 +57,3 @@ coder tokens [flags]
 - [coder tokens create](coder_tokens_create.md) - Create a tokens
 - [coder tokens list](coder_tokens_list.md) - List tokens
 - [coder tokens remove](coder_tokens_remove.md) - Delete a token
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_tokens_create.md b/docs/cli/coder_tokens_create.md
@@ -36,5 +36,3 @@ coder tokens create [flags]
 ### SEE ALSO
 
 - [coder tokens](coder_tokens.md) - Manage personal access tokens
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_tokens_list.md b/docs/cli/coder_tokens_list.md
@@ -34,5 +34,3 @@ coder tokens list [flags]
 ### SEE ALSO
 
 - [coder tokens](coder_tokens.md) - Manage personal access tokens
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_tokens_remove.md b/docs/cli/coder_tokens_remove.md
@@ -34,5 +34,3 @@ coder tokens remove [id] [flags]
 ### SEE ALSO
 
 - [coder tokens](coder_tokens.md) - Manage personal access tokens
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_update.md b/docs/cli/coder_update.md
@@ -39,5 +39,3 @@ coder update <workspace> [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_users.md b/docs/cli/coder_users.md
@@ -39,5 +39,3 @@ coder users [flags]
 - [coder users list](coder_users_list.md) -
 - [coder users show](coder_users_show.md) - Show a single user. Use 'me' to indicate the currently authenticated user.
 - [coder users suspend](coder_users_suspend.md) - Update a user's status to 'suspended'. A suspended user cannot log into the platform
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_users_activate.md b/docs/cli/coder_users_activate.md
@@ -41,5 +41,3 @@ coder users activate <username|user_id> [flags]
 ### SEE ALSO
 
 - [coder users](coder_users.md) - Manage users
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_users_create.md b/docs/cli/coder_users_create.md
@@ -35,5 +35,3 @@ coder users create [flags]
 ### SEE ALSO
 
 - [coder users](coder_users.md) - Manage users
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_users_list.md b/docs/cli/coder_users_list.md
@@ -34,5 +34,3 @@ coder users list [flags]
 ### SEE ALSO
 
 - [coder users](coder_users.md) - Manage users
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_users_show.md b/docs/cli/coder_users_show.md
@@ -41,5 +41,3 @@ coder users show <username|user_id|'me'> [flags]
 ### SEE ALSO
 
 - [coder users](coder_users.md) - Manage users
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_users_suspend.md b/docs/cli/coder_users_suspend.md
@@ -41,5 +41,3 @@ coder users suspend <username|user_id> [flags]
 ### SEE ALSO
 
 - [coder users](coder_users.md) - Manage users
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/docs/cli/coder_version.md b/docs/cli/coder_version.md
@@ -34,5 +34,3 @@ coder version [flags]
 ### SEE ALSO
 
 - [coder](coder.md) -
-
-###### Auto generated by spf13/cobra on 27-Jan-2023
diff --git a/scripts/clidocgen/main.go b/scripts/clidocgen/main.go
@@ -9,6 +9,7 @@ import (
 	"regexp"
 	"strings"
 
+	"github.com/spf13/cobra"
 	"github.com/spf13/cobra/doc"
 
 	"github.com/coder/coder/buildinfo"
@@ -63,6 +64,16 @@ func main() {
 	markdownDocsDir := path.Join(basePath, "docs/cli")
 	manifestFilepath := path.Join(basePath, "docs/manifest.json")
 
+	// Disables the "Auto generated by spf13/cobra" tag
+	var disableAutoGenTag func(cmd *cobra.Command)
+	disableAutoGenTag = func(cmd *cobra.Command) {
+		for _, c := range cmd.Commands() {
+			disableAutoGenTag(c)
+		}
+		cmd.DisableAutoGenTag = true
+	}
+	disableAutoGenTag(cmd)
+
 	// Generate markdown
 	err = doc.GenMarkdownTree(cmd, markdownDocsDir)
 	if err != nil {
