SKE Credentials Rotation: deprecate old commands (#191)

* deprecate describe and rotate commands

* improve deprecation messages, add docs

Author: DiogoFerrao

docs/stackit_ske_credentials.md

@@ -29,7 +29,5 @@ stackit ske credentials [flags]
 
 * [stackit ske](./stackit_ske.md)	 - Provides functionality for SKE
 * [stackit ske credentials complete-rotation](./stackit_ske_credentials_complete-rotation.md)	 - Completes the rotation of the credentials associated to a SKE cluster
-* [stackit ske credentials describe](./stackit_ske_credentials_describe.md)	 - Shows details of the credentials associated to a SKE cluster
-* [stackit ske credentials rotate](./stackit_ske_credentials_rotate.md)	 - Rotates credentials associated to a SKE cluster
 * [stackit ske credentials start-rotation](./stackit_ske_credentials_start-rotation.md)	 - Starts the rotation of the credentials associated to a SKE cluster
 

docs/stackit_ske_credentials_describe.md

@@ -35,7 +35,7 @@ stackit ske kubeconfig create CLUSTER_NAME [flags]
 
 ```
   -e, --expiration string   Expiration time for the kubeconfig in seconds(s), minutes(m), hours(h), days(d) or months(M). Example: 30d. By default, expiration time is 1h
-      --filepath string     Path to create the kubeconfig file. By default, the kubeconfig is created in the .kube folder, in the user's home directory.
+      --filepath string     Path to create the kubeconfig file. By default, the kubeconfig is created as 'config' in the .kube folder, in the user's home directory.
   -h, --help                Help for "stackit ske kubeconfig create"
 ```
 

docs/stackit_ske_credentials_rotate.md

@@ -32,6 +32,12 @@ func NewCmd() *cobra.Command {
 		Short: "Shows details of the credentials associated to a SKE cluster",
 		Long:  "Shows details of the credentials associated to a STACKIT Kubernetes Engine (SKE) cluster",
 		Args:  args.SingleArg(clusterNameArg, nil),
+		Deprecated: fmt.Sprintf("%s\n%s\n%s\n%s\n",
+			"and will be removed in a future release.",
+			"Please use the following command to obtain a kubeconfig file instead:",
+			" $ stackit ske kubeconfig create my-cluster",
+			"For more information, visit: https://docs.stackit.cloud/stackit/en/how-to-rotate-ske-credentials-200016334.html",
+		),
 		Example: examples.Build(
 			examples.NewExample(
 				`Get details of the credentials associated to the SKE cluster with name "my-cluster"`,

docs/stackit_ske_kubeconfig_create.md

@@ -32,6 +32,13 @@ func NewCmd() *cobra.Command {
 		Short: "Rotates credentials associated to a SKE cluster",
 		Long:  "Rotates credentials associated to a STACKIT Kubernetes Engine (SKE) cluster. The old credentials will be invalid after the operation.",
 		Args:  args.SingleArg(clusterNameArg, nil),
+		Deprecated: fmt.Sprintf("%s\n%s\n%s\n%s\n%s\n",
+			"and will be removed in a future release.",
+			"Please use the 2-step credential rotation flow instead, by running the commands:",
+			" $ stackit ske credentials start-rotation my-cluster",
+			" $ stackit ske credentials complete-rotation my-cluster",
+			"For more information, visit: https://docs.stackit.cloud/stackit/en/how-to-rotate-ske-credentials-200016334.html",
+		),
 		Example: examples.Build(
 			examples.NewExample(
 				`Rotate credentials associated to the SKE cluster with name "my-cluster"`,