docs(secret-manager): update description (#2997)

Author: scaleway-bot

cmd/scw/testdata/test-all-usage-secret-version-access-usage.golden

@@ -7,7 +7,7 @@ USAGE:
 
 ARGS:
   secret-id         ID of the secret
-  revision          Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest"
+  revision          Version number
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par)
 
 FLAGS:

cmd/scw/testdata/test-all-usage-secret-version-delete-usage.golden

@@ -11,7 +11,7 @@ EXAMPLES:
 
 ARGS:
   secret-id         ID of the secret
-  revision          Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest"
+  revision          Version number
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par)
 
 FLAGS:

cmd/scw/testdata/test-all-usage-secret-version-disable-usage.golden

@@ -7,7 +7,7 @@ USAGE:
 
 ARGS:
   secret-id         ID of the secret
-  revision          Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest"
+  revision          Version number
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par)
 
 FLAGS:

cmd/scw/testdata/test-all-usage-secret-version-enable-usage.golden

@@ -7,7 +7,7 @@ USAGE:
 
 ARGS:
   secret-id         ID of the secret
-  revision          Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest"
+  revision          Version number
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par)
 
 FLAGS:

cmd/scw/testdata/test-all-usage-secret-version-get-usage.golden

@@ -7,7 +7,7 @@ USAGE:
 
 ARGS:
   secret-id         ID of the secret
-  revision          Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest"
+  revision          Version number
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par)
 
 FLAGS:

cmd/scw/testdata/test-all-usage-secret-version-update-usage.golden

@@ -7,7 +7,7 @@ USAGE:
 
 ARGS:
   secret-id         ID of the secret
-  revision          Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest"
+  revision          Version number
   [description]     Description of the version
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par)
 

docs/commands/secret.md

@@ -24,7 +24,6 @@ Secret Manager API documentation.
 Secrets are logical containers made up of zero or more immutable versions, that contain sensitive data.
 
 
-
 ### Create a secret
 
 You must sepcify the `region` to create a secret.
@@ -160,7 +159,6 @@ scw secret secret update [arg=value ...]
 Versions store the sensitive data contained in your secrets (API keys, passwords, or certificates).
 
 
-
 ### Access a secret's version using the secret's ID
 
 Access sensitive data in a secret's version specified by the `region`, `secret_id` and `revision` parameters.
@@ -177,7 +175,7 @@ scw secret version access [arg=value ...]
 | Name |   | Description |
 |------|---|-------------|
 | secret-id | Required | ID of the secret |
-| revision | Required | Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest" |
+| revision | Required | Version number |
 | region | Default: `fr-par`<br />One of: `fr-par` | Region to target. If none is passed will use default region from the config |
 
 
@@ -226,7 +224,7 @@ scw secret version delete [arg=value ...]
 | Name |   | Description |
 |------|---|-------------|
 | secret-id | Required | ID of the secret |
-| revision | Required | Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest" |
+| revision | Required | Version number |
 | region | Default: `fr-par`<br />One of: `fr-par` | Region to target. If none is passed will use default region from the config |
 
 
@@ -257,7 +255,7 @@ scw secret version disable [arg=value ...]
 | Name |   | Description |
 |------|---|-------------|
 | secret-id | Required | ID of the secret |
-| revision | Required | Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest" |
+| revision | Required | Version number |
 | region | Default: `fr-par`<br />One of: `fr-par` | Region to target. If none is passed will use default region from the config |
 
 
@@ -278,7 +276,7 @@ scw secret version enable [arg=value ...]
 | Name |   | Description |
 |------|---|-------------|
 | secret-id | Required | ID of the secret |
-| revision | Required | Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest" |
+| revision | Required | Version number |
 | region | Default: `fr-par`<br />One of: `fr-par` | Region to target. If none is passed will use default region from the config |
 
 
@@ -299,7 +297,7 @@ scw secret version get [arg=value ...]
 | Name |   | Description |
 |------|---|-------------|
 | secret-id | Required | ID of the secret |
-| revision | Required | Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest" |
+| revision | Required | Version number |
 | region | Default: `fr-par`<br />One of: `fr-par` | Region to target. If none is passed will use default region from the config |
 
 
@@ -341,7 +339,7 @@ scw secret version update [arg=value ...]
 | Name |   | Description |
 |------|---|-------------|
 | secret-id | Required | ID of the secret |
-| revision | Required | Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest" |
+| revision | Required | Version number |
 | description |  | Description of the version |
 | region | Default: `fr-par`<br />One of: `fr-par` | Region to target. If none is passed will use default region from the config |
 

internal/namespaces/secret/v1alpha1/secret_cli.go

@@ -47,19 +47,17 @@ func secretRoot() *core.Command {
 
 func secretSecret() *core.Command {
 	return &core.Command{
-		Short: `Secret management commands`,
-		Long: `Secrets are logical containers made up of zero or more immutable versions, that contain sensitive data.
-`,
+		Short:     `Secret management commands`,
+		Long:      `Secrets are logical containers made up of zero or more immutable versions, that contain sensitive data.`,
 		Namespace: "secret",
 		Resource:  "secret",
 	}
 }
 
 func secretVersion() *core.Command {
 	return &core.Command{
-		Short: `Secret Version management commands`,
-		Long: `Versions store the sensitive data contained in your secrets (API keys, passwords, or certificates).
-`,
+		Short:     `Secret Version management commands`,
+		Long:      `Versions store the sensitive data contained in your secrets (API keys, passwords, or certificates).`,
 		Namespace: "secret",
 		Resource:  "version",
 	}
@@ -411,7 +409,7 @@ func secretVersionGet() *core.Command {
 			},
 			{
 				Name:       "revision",
-				Short:      `Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest"`,
+				Short:      `Version number`,
 				Required:   true,
 				Deprecated: false,
 				Positional: false,
@@ -448,7 +446,7 @@ func secretVersionUpdate() *core.Command {
 			},
 			{
 				Name:       "revision",
-				Short:      `Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest"`,
+				Short:      `Version number`,
 				Required:   true,
 				Deprecated: false,
 				Positional: false,
@@ -539,7 +537,7 @@ func secretVersionDelete() *core.Command {
 			},
 			{
 				Name:       "revision",
-				Short:      `Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest"`,
+				Short:      `Version number`,
 				Required:   true,
 				Deprecated: false,
 				Positional: false,
@@ -582,7 +580,7 @@ func secretVersionEnable() *core.Command {
 			},
 			{
 				Name:       "revision",
-				Short:      `Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest"`,
+				Short:      `Version number`,
 				Required:   true,
 				Deprecated: false,
 				Positional: false,
@@ -619,7 +617,7 @@ func secretVersionDisable() *core.Command {
 			},
 			{
 				Name:       "revision",
-				Short:      `Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest"`,
+				Short:      `Version number`,
 				Required:   true,
 				Deprecated: false,
 				Positional: false,
@@ -656,7 +654,7 @@ func secretVersionAccess() *core.Command {
 			},
 			{
 				Name:       "revision",
-				Short:      `Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest"`,
+				Short:      `Version number`,
 				Required:   true,
 				Deprecated: false,
 				Positional: false,