Remove date metadata in auto-generated documentation (#65)

OliverTrautvetter · web-flow · commit 0d92b21dad91 · 2025-11-10T13:05:46.000+01:00
### Fix: Remove date metadata in auto-generated documentation Addresses an issue where the auto-regeneration of documentation in every PR causes the file modification date to be appended to each documentation file. --- **[ClickUp Card](https://app.clickup.com/t/869b06ttg)** --------- Signed-off-by: OliverTrautvetter <66372584+OliverTrautvetter@users.noreply.github.com>
diff --git a/Makefile b/Makefile
@@ -56,7 +56,7 @@ release-local: install-build-deps
 docs:
 	rm -rf docs
 	mkdir docs
-	go run -ldflags="-X 'github.com/codesphere-cloud/oms/internal/version.binName=oms-cli'" hack/gendocs/main.go 
+	go run -ldflags="-X 'github.com/codesphere-cloud/oms/internal/version.binName=oms-cli'" hack/gendocs/main.go
 	cp docs/oms-cli.md docs/README.md
 
 generate-license: generate
diff --git a/docs/README.md b/docs/README.md
@@ -28,4 +28,3 @@ like downloading new versions.
 * [oms-cli update](oms-cli_update.md)	 - Update OMS related resources
 * [oms-cli version](oms-cli_version.md)	 - Print version
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli.md b/docs/oms-cli.md
@@ -28,4 +28,3 @@ like downloading new versions.
 * [oms-cli update](oms-cli_update.md)	 - Update OMS related resources
 * [oms-cli version](oms-cli_version.md)	 - Print version
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_beta.md b/docs/oms-cli_beta.md
@@ -18,4 +18,3 @@ Be aware that that usage and behavior may change as the features are developed.
 * [oms-cli](oms-cli.md)	 - Codesphere Operations Management System (OMS)
 * [oms-cli beta extend](oms-cli_beta_extend.md)	 - Extend Codesphere ressources such as base images.
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_beta_extend.md b/docs/oms-cli_beta_extend.md
@@ -17,4 +17,3 @@ Extend Codesphere ressources such as base images to customize them for your need
 * [oms-cli beta](oms-cli_beta.md)	 - Commands for early testing
 * [oms-cli beta extend baseimage](oms-cli_beta_extend_baseimage.md)	 - Extend Codesphere's workspace base image for customization
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_beta_extend_baseimage.md b/docs/oms-cli_beta_extend_baseimage.md
@@ -28,4 +28,3 @@ oms-cli beta extend baseimage [flags]
 
 * [oms-cli beta extend](oms-cli_beta_extend.md)	 - Extend Codesphere ressources such as base images.
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_build.md b/docs/oms-cli_build.md
@@ -18,4 +18,3 @@ Build and push container images to a registry using the provided configuration.
 * [oms-cli build image](oms-cli_build_image.md)	 - Build and push Docker image using Dockerfile and Codesphere package version
 * [oms-cli build images](oms-cli_build_images.md)	 - Build and push container images
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_build_image.md b/docs/oms-cli_build_image.md
@@ -32,4 +32,3 @@ $ oms-cli build image --dockerfile baseimage/Dockerfile --package codesphere-v1.
 
 * [oms-cli build](oms-cli_build.md)	 - Build and push images to a registry
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_build_images.md b/docs/oms-cli_build_images.md
@@ -23,4 +23,3 @@ oms-cli build images [flags]
 
 * [oms-cli build](oms-cli_build.md)	 - Build and push images to a registry
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_download.md b/docs/oms-cli_download.md
@@ -18,4 +18,3 @@ e.g. available Codesphere packages
 * [oms-cli](oms-cli.md)	 - Codesphere Operations Management System (OMS)
 * [oms-cli download package](oms-cli_download_package.md)	 - Download a codesphere package
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_download_package.md b/docs/oms-cli_download_package.md
@@ -36,4 +36,3 @@ $ oms-cli download package --version codesphere-v1.55.0 --file installer-lite.ta
 
 * [oms-cli download](oms-cli_download.md)	 - Download resources available through OMS
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_install.md b/docs/oms-cli_install.md
@@ -17,4 +17,3 @@ Coming soon: Install Codesphere and other components like Ceph and PostgreSQL.
 * [oms-cli](oms-cli.md)	 - Codesphere Operations Management System (OMS)
 * [oms-cli install codesphere](oms-cli_install_codesphere.md)	 - Install a Codesphere instance
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_install_codesphere.md b/docs/oms-cli_install_codesphere.md
@@ -26,4 +26,3 @@ oms-cli install codesphere [flags]
 
 * [oms-cli install](oms-cli_install.md)	 - Coming soon: Install Codesphere and other components
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_licenses.md b/docs/oms-cli_licenses.md
@@ -20,4 +20,3 @@ oms-cli licenses [flags]
 
 * [oms-cli](oms-cli.md)	 - Codesphere Operations Management System (OMS)
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_list.md b/docs/oms-cli_list.md
@@ -19,4 +19,3 @@ eg. available Codesphere packages
 * [oms-cli list api-keys](oms-cli_list_api-keys.md)	 - List API keys
 * [oms-cli list packages](oms-cli_list_packages.md)	 - List available packages
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_list_api-keys.md b/docs/oms-cli_list_api-keys.md
@@ -20,4 +20,3 @@ oms-cli list api-keys [flags]
 
 * [oms-cli list](oms-cli_list.md)	 - List resources available through OMS
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_list_packages.md b/docs/oms-cli_list_packages.md
@@ -20,4 +20,3 @@ oms-cli list packages [flags]
 
 * [oms-cli list](oms-cli_list.md)	 - List resources available through OMS
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_register.md b/docs/oms-cli_register.md
@@ -24,4 +24,3 @@ oms-cli register [flags]
 
 * [oms-cli](oms-cli.md)	 - Codesphere Operations Management System (OMS)
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_revoke.md b/docs/oms-cli_revoke.md
@@ -18,4 +18,3 @@ eg. api keys.
 * [oms-cli](oms-cli.md)	 - Codesphere Operations Management System (OMS)
 * [oms-cli revoke api-key](oms-cli_revoke_api-key.md)	 - Revoke an API key
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_revoke_api-key.md b/docs/oms-cli_revoke_api-key.md
@@ -21,4 +21,3 @@ oms-cli revoke api-key [flags]
 
 * [oms-cli revoke](oms-cli_revoke.md)	 - Revoke resources available through OMS
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_update.md b/docs/oms-cli_update.md
@@ -24,4 +24,3 @@ oms-cli update [flags]
 * [oms-cli update oms](oms-cli_update_oms.md)	 - Update the OMS CLI
 * [oms-cli update package](oms-cli_update_package.md)	 - Download a codesphere package
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_update_api-key.md b/docs/oms-cli_update_api-key.md
@@ -22,4 +22,3 @@ oms-cli update api-key [flags]
 
 * [oms-cli update](oms-cli_update.md)	 - Update OMS related resources
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_update_dockerfile.md b/docs/oms-cli_update_dockerfile.md
@@ -38,4 +38,3 @@ $ oms-cli update dockerfile --dockerfile baseimage/Dockerfile --package codesphe
 
 * [oms-cli update](oms-cli_update.md)	 - Update OMS related resources
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_update_oms.md b/docs/oms-cli_update_oms.md
@@ -20,4 +20,3 @@ oms-cli update oms [flags]
 
 * [oms-cli update](oms-cli_update.md)	 - Update OMS related resources
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_update_package.md b/docs/oms-cli_update_package.md
@@ -36,4 +36,3 @@ $ oms-cli download package --version codesphere-v1.55.0 --file installer-lite.ta
 
 * [oms-cli update](oms-cli_update.md)	 - Update OMS related resources
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/docs/oms-cli_version.md b/docs/oms-cli_version.md
@@ -20,4 +20,3 @@ oms-cli version [flags]
 
 * [oms-cli](oms-cli.md)	 - Codesphere Operations Management System (OMS)
 
-###### Auto generated by spf13/cobra on 7-Nov-2025
diff --git a/hack/gendocs/main.go b/hack/gendocs/main.go
@@ -15,7 +15,11 @@ func main() {
 	root := oms.GetRootCmd()
 	root.Use = "oms-cli"
 
-	err := doc.GenMarkdownTree(root, "docs")
+	root.DisableAutoGenTag = true
+
+	identity := func(s string) string { return s }
+	emptyStr := func(s string) string { return "" }
+	err := doc.GenMarkdownTreeCustom(root, "docs", emptyStr, identity)
 	if err != nil {
 		log.Fatal(err)
 	}

Original file line number	Diff line number	Diff line change
`@@ -28,4 +28,3 @@ like downloading new versions.`
`28`	`28`	`* [oms-cli update](oms-cli_update.md) - Update OMS related resources`
`29`	`29`	`* [oms-cli version](oms-cli_version.md) - Print version`
`30`	`30`
`31`		`-###### Auto generated by spf13/cobra on 7-Nov-2025`
Original file line number	Diff line number	Diff line change
`@@ -18,4 +18,3 @@ Be aware that that usage and behavior may change as the features are developed.`
`18`	`18`	`* [oms-cli](oms-cli.md) - Codesphere Operations Management System (OMS)`
`19`	`19`	`* [oms-cli beta extend](oms-cli_beta_extend.md) - Extend Codesphere ressources such as base images.`
`20`	`20`
`21`		`-###### Auto generated by spf13/cobra on 7-Nov-2025`
Original file line number	Diff line number	Diff line change
`@@ -17,4 +17,3 @@ Extend Codesphere ressources such as base images to customize them for your need`
`17`	`17`	`* [oms-cli beta](oms-cli_beta.md) - Commands for early testing`
`18`	`18`	`* [oms-cli beta extend baseimage](oms-cli_beta_extend_baseimage.md) - Extend Codesphere's workspace base image for customization`
`19`	`19`
`20`		`-###### Auto generated by spf13/cobra on 7-Nov-2025`
Original file line number	Diff line number	Diff line change
`@@ -28,4 +28,3 @@ oms-cli beta extend baseimage [flags]`
`28`	`28`
`29`	`29`	`* [oms-cli beta extend](oms-cli_beta_extend.md) - Extend Codesphere ressources such as base images.`
`30`	`30`
`31`		`-###### Auto generated by spf13/cobra on 7-Nov-2025`
Original file line number	Diff line number	Diff line change
`@@ -18,4 +18,3 @@ Build and push container images to a registry using the provided configuration.`
`18`	`18`	`* [oms-cli build image](oms-cli_build_image.md) - Build and push Docker image using Dockerfile and Codesphere package version`
`19`	`19`	`* [oms-cli build images](oms-cli_build_images.md) - Build and push container images`
`20`	`20`
`21`		`-###### Auto generated by spf13/cobra on 7-Nov-2025`
Original file line number	Diff line number	Diff line change
`@@ -32,4 +32,3 @@ $ oms-cli build image --dockerfile baseimage/Dockerfile --package codesphere-v1.`
`32`	`32`
`33`	`33`	`* [oms-cli build](oms-cli_build.md) - Build and push images to a registry`
`34`	`34`
`35`		`-###### Auto generated by spf13/cobra on 7-Nov-2025`
Original file line number	Diff line number	Diff line change
`@@ -23,4 +23,3 @@ oms-cli build images [flags]`
`23`	`23`
`24`	`24`	`* [oms-cli build](oms-cli_build.md) - Build and push images to a registry`
`25`	`25`
`26`		`-###### Auto generated by spf13/cobra on 7-Nov-2025`
Original file line number	Diff line number	Diff line change
`@@ -18,4 +18,3 @@ e.g. available Codesphere packages`
`18`	`18`	`* [oms-cli](oms-cli.md) - Codesphere Operations Management System (OMS)`
`19`	`19`	`* [oms-cli download package](oms-cli_download_package.md) - Download a codesphere package`
`20`	`20`
`21`		`-###### Auto generated by spf13/cobra on 7-Nov-2025`