refactor(mnq): make Permissions optional (#3038)

Co-authored-by: Rémy Léone <rleone@scaleway.com>

Author: scaleway-bot

cmd/scw/testdata/test-all-usage-mnq-credential-create-usage.golden

@@ -1,16 +1,16 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Create a set of credentials for a specific namespace.
+Create a set of credentials for a Messaging and Queuing namespace, specified by its namespace ID. If creating credentials for a NATS namespace, the `permissions` object must not be included in the request. If creating credentials for an SQS/SNS namespace, the `permissions` object is required, with all three of its child attributes.
 
 USAGE:
   scw mnq credential create [arg=value ...]
 
 ARGS:
-  namespace-id                Namespace containing the Credential
-  [name=<generated>]          Credential name
-  [permissions.can-publish]   Defines if user can publish messages to the service
-  [permissions.can-receive]   Defines if user can receive messages from the service
-  [permissions.can-manage]    Defines if user can manage the associated resource(s)
+  namespace-id                Namespace containing the credentials
+  [name=<generated>]          Name of the credentials
+  [permissions.can-publish]   Defines whether the credentials bearer can publish messages to the service (send messages to SQS queues or publish to SNS topics)
+  [permissions.can-receive]   Defines whether the credentials bearer can receive messages from the service
+  [permissions.can-manage]    Defines whether the credentials bearer can manage the associated resources (SQS queues or SNS topics or subscriptions)
   [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-mnq-credential-delete-usage.golden

@@ -1,12 +1,12 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Delete credentials.
+Delete a set of credentials, specified by their credential ID. Deleting credentials is irreversible and cannot be undone. The credentials can no longer be used to access the namespace.
 
 USAGE:
   scw mnq credential delete <credential-id ...> [arg=value ...]
 
 ARGS:
-  credential-id     ID of the Credential to delete
+  credential-id     ID of the credentials to delete
   [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-mnq-credential-get-usage.golden

@@ -1,12 +1,12 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Get a set of credentials.
+Retrieve an existing set of credentials, identified by the `credential_id`. The credentials themselves, as well as their metadata (protocol, namespace ID etc), are returned in the response.
 
 USAGE:
   scw mnq credential get <credential-id ...> [arg=value ...]
 
 ARGS:
-  credential-id     ID of the Credential to get
+  credential-id     ID of the credentials to get
   [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-mnq-credential-list-usage.golden

@@ -1,13 +1,13 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-List credentials.
+List existing credentials in the specified region. The response contains only the metadata for the credentials, not the credentials themselves (for this, use **Get Credentials**).
 
 USAGE:
   scw mnq credential list [arg=value ...]
 
 ARGS:
-  [namespace-id]    Namespace containing the Credential
-  [order-by]        Field used for sorting results (id_asc | id_desc | name_asc | name_desc)
+  [namespace-id]    Namespace containing the credentials
+  [order-by]        Order in which to return results (id_asc | id_desc | name_asc | name_desc)
   [region=fr-par]   Region to target. If none is passed will use default region from the config (fr-par | all)
 
 FLAGS:

cmd/scw/testdata/test-all-usage-mnq-credential-update-usage.golden

@@ -1,16 +1,16 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Update a set of credentials.
+Update a set of credentials. You can update the credentials' name, or (in the case of SQS/SNS credentials only) their permissions. To update the name of NATS credentials, do not include the `permissions` object in your request.
 
 USAGE:
   scw mnq credential update <credential-id ...> [arg=value ...]
 
 ARGS:
-  credential-id               ID of the Credential to update
-  [name]                      Credential name
-  [permissions.can-publish]   Defines if user can publish messages to the service
-  [permissions.can-receive]   Defines if user can receive messages from the service
-  [permissions.can-manage]    Defines if user can manage the associated resource(s)
+  credential-id               ID of the credentials to update
+  [name]                      Name of the credentials
+  [permissions.can-publish]   Defines whether the credentials bearer can publish messages to the service (send messages to SQS queues or publish to SNS topics)
+  [permissions.can-receive]   Defines whether the credentials bearer can receive messages from the service
+  [permissions.can-manage]    Defines whether the credentials bearer can manage the associated resources (SQS queues or SNS topics or subscriptions)
   [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-mnq-credential-usage.golden

@@ -6,11 +6,11 @@ USAGE:
   scw mnq credential <command>
 
 AVAILABLE COMMANDS:
-  create      Create a set of credentials
+  create      Create credentials
   delete      Delete credentials
-  get         Get a set of credentials
+  get         Get credentials
   list        List credentials
-  update      Update a set of credentials
+  update      Update credentials
 
 FLAGS:
   -h, --help   help for credential

cmd/scw/testdata/test-all-usage-mnq-namespace-create-usage.golden

@@ -1,13 +1,13 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Create a namespace.
+Create a Messaging and Queuing namespace, set to the desired protocol.
 
 USAGE:
   scw mnq namespace create [arg=value ...]
 
 ARGS:
   [name=<generated>]   Namespace name
-  protocol             Namespace protocol (unknown | nats | sqs_sns)
+  protocol             Namespace protocol. You must specify a valid protocol (and not `unknown`) to avoid an error. (unknown | nats | sqs_sns)
   [project-id]         Project ID to use. If none is passed the default project ID will be used
   [region=fr-par]      Region to target. If none is passed will use default region from the config (fr-par)
 

cmd/scw/testdata/test-all-usage-mnq-namespace-delete-usage.golden

@@ -1,12 +1,12 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Delete a namespace.
+Delete a Messaging and Queuing namespace, specified by its namespace ID. Note that deleting a namespace is irreversible, and any URLs, credentials and queued messages belonging to this namespace will also be deleted.
 
 USAGE:
   scw mnq namespace delete <namespace-id ...> [arg=value ...]
 
 ARGS:
-  namespace-id      ID of the Namespace to delete
+  namespace-id      ID of the namespace to delete
   [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-mnq-namespace-get-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Get a namespace.
+Retrieve information about an existing Messaging and Queuing namespace, identified by its namespace ID. Its full details, including name, endpoint and protocol, are returned in the response.
 
 USAGE:
   scw mnq namespace get <namespace-id ...> [arg=value ...]

cmd/scw/testdata/test-all-usage-mnq-namespace-list-usage.golden

@@ -1,14 +1,14 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-List namespaces.
+List all Messaging and Queuing namespaces in the specified region, for a Scaleway Organization or Project. By default, the namespaces returned in the list are ordered by creation date in ascending order, though this can be modified via the `order_by` field.
 
 USAGE:
   scw mnq namespace list [arg=value ...]
 
 ARGS:
-  [project-id]        Will list only the Namespaces contained into the specified project
-  [order-by]          Field used for sorting results (created_at_asc | created_at_desc | updated_at_asc | updated_at_desc | id_asc | id_desc | name_asc | name_desc | project_id_asc | project_id_desc)
-  [organization-id]   Will list only the Namespaces owned by the specified organization
+  [project-id]        Include only namespaces in this Project
+  [order-by]          Order in which to return results (created_at_asc | created_at_desc | updated_at_asc | updated_at_desc | id_asc | id_desc | name_asc | name_desc | project_id_asc | project_id_desc)
+  [organization-id]   Include only namespaces in this Organization
   [region=fr-par]     Region to target. If none is passed will use default region from the config (fr-par | all)
 
 FLAGS: