Try adding header to generated CLI docs

Fix #2834

cmd/kops/gen_help_docs.go

@@ -21,6 +21,11 @@ import (
 	"github.com/spf13/cobra/doc"
 )
 
+const fileHeader = `
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
+`
+
 type GenHelpDocsCmd struct {
 	cobraCommand *cobra.Command
 	OutDir       string
@@ -55,5 +60,9 @@ func (c *GenHelpDocsCmd) Run() error {
 	for _, c := range rootCommand.cobraCommand.Commands() {
 		c.Flag("state").DefValue = ""
 	}
-	return doc.GenMarkdownTree(rootCommand.cobraCommand, c.OutDir)
+
+	linkHandler := func(link string) string { return link }
+	filePrepender := func(filname string) string { return fileHeader }
+
+	return doc.GenMarkdownTreeCustom(rootCommand.cobraCommand, c.OutDir, filePrepender, linkHandler)
 }

docs/cli/kops.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops
 
 kops is Kubernetes ops.

docs/cli/kops_completion.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops completion
 
 Output shell completion code for the given shell (bash or zsh).

docs/cli/kops_create.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops create
 
 Create a resource by command line, filename or stdin.

docs/cli/kops_create_cluster.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops create cluster
 
 Create a Kubernetes cluster.

docs/cli/kops_create_instancegroup.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops create instancegroup
 
 Create an instancegroup.

docs/cli/kops_create_secret.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops create secret
 
 Create a secret.

docs/cli/kops_create_secret_sshpublickey.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops create secret sshpublickey
 
 Create a ssh public key.

docs/cli/kops_delete.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops delete
 
 Delete clusters,instancegroups, or secrets.

docs/cli/kops_delete_cluster.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops delete cluster
 
 Delete a cluster.

docs/cli/kops_delete_instancegroup.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops delete instancegroup
 
 Delete instancegroup

docs/cli/kops_delete_secret.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops delete secret
 
 Delete a secret

docs/cli/kops_describe.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops describe
 
 Describe a resource.

docs/cli/kops_describe_secrets.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops describe secrets
 
 Describe a cluster secret

docs/cli/kops_edit.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops edit
 
 Edit clusters and other resources.

docs/cli/kops_edit_cluster.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops edit cluster
 
 Edit cluster.

docs/cli/kops_edit_federation.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops edit federation
 
 Edit federation.

docs/cli/kops_edit_instancegroup.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops edit instancegroup
 
 Edit instancegroup.

docs/cli/kops_export.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops export
 
 Export configuration.

docs/cli/kops_export_kubecfg.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops export kubecfg
 
 Export kubecfg.

docs/cli/kops_get.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops get
 
 Get one or many resources.

docs/cli/kops_get_clusters.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops get clusters
 
 Get one or many clusters.

docs/cli/kops_get_federations.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops get federations
 
 Get federation.

docs/cli/kops_get_instancegroups.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops get instancegroups
 
 Get one or many instancegroups

docs/cli/kops_get_secrets.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops get secrets
 
 Get one or many secrets.

docs/cli/kops_import.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops import
 
 Import a cluster.

docs/cli/kops_import_cluster.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops import cluster
 
 Import a cluster.

docs/cli/kops_replace.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops replace
 
 Replace cluster resources.

docs/cli/kops_rolling-update.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops rolling-update
 
 Rolling update a cluster.

docs/cli/kops_rolling-update_cluster.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops rolling-update cluster
 
 Rolling update a cluster.

docs/cli/kops_toolbox.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops toolbox
 
 Misc infrequently used commands.

docs/cli/kops_toolbox_convert-imported.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops toolbox convert-imported
 
 Convert an imported cluster into a kops cluster.

docs/cli/kops_toolbox_dump.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops toolbox dump
 
 Dump cluster information

docs/cli/kops_update.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops update
 
 Update a cluster.

docs/cli/kops_update_cluster.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops update cluster
 
 Update a cluster.

docs/cli/kops_update_federation.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops update federation
 
 Update federation cluster resources.

docs/cli/kops_upgrade.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops upgrade
 
 Upgrade a kubernetes cluster.

docs/cli/kops_upgrade_cluster.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops upgrade cluster
 
 Upgrade a kubernetes cluster.

docs/cli/kops_validate.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops validate
 
 Validate a kops cluster.

docs/cli/kops_validate_cluster.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops validate cluster
 
 Validate a kops cluster.

docs/cli/kops_version.md

@@ -1,3 +1,6 @@
+
+<!--- This file is automatically generated by make gen-cli-docs; changes should be made in the go CLI command code (under cmd/kops) -->
+
 ## kops version
 
 Print the kops version information.