docs(secret_manager): revamp secret manager (#627)

Author: scaleway-bot

packages/clients/src/api/secret/v1alpha1/api.gen.ts

@@ -50,10 +50,10 @@ const jsonContentHeaders = {
 }
 
 /**
- * Secret Manager API documentation.
+ * Secret Manager API.
  *
- * This API allows you to conveniently store, access and share sensitive data.
- * Secret Manager API documentation.
+ * Secret Manager API. This API allows you to conveniently store, access and
+ * share sensitive data.
  */
 export class API extends ParentAPI {
   /** Lists the available regions of the API. */

packages/clients/src/api/secret/v1alpha1/types.gen.ts

@@ -30,8 +30,8 @@ export interface AccessSecretVersionResponse {
   /** The base64-encoded secret payload of the version. */
   data: string
   /**
-   * The CRC32 checksum of the data as a base-10 integer. This field is present
-   * only if a CRC32 was supplied during the creation of the version.
+   * The CRC32 checksum of the data as a base-10 integer. This field is only
+   * available if a CRC32 was supplied during the creation of the version.
    */
   dataCrc32?: number
 }
@@ -235,7 +235,7 @@ export type CreateSecretVersionRequest = {
   disablePrevious?: boolean
   /**
    * Options to generate a password. Optional. If specified, a random password
-   * will be generated. The data and data_crc32 fields must be empty. By
+   * will be generated. The `data` and `data_crc32` fields must be empty. By
    * default, the generator will use upper and lower case letters, and digits.
    * This behavior can be tuned using the generation parameters.
    *
@@ -245,9 +245,9 @@ export type CreateSecretVersionRequest = {
   passwordGeneration?: PasswordGenerationParams
   /**
    * The CRC32 checksum of the data as a base-10 integer. Optional. If
-   * specified, the Secret Manager will verify the integrity of the data
-   * received against the given CRC32. An error is returned if the CRC32 does
-   * not match. Otherwise, the CRC32 will be stored and returned along with the
+   * specified, Secret Manager will verify the integrity of the data received
+   * against the given CRC32. An error is returned if the CRC32 does not match.
+   * Otherwise, the CRC32 will be stored and returned along with the
    * SecretVersion on futur accesses.
    */
   dataCrc32?: number