CLOUDP-303333 Improve --file description for auto-generated commands (#…

…3709)

.github/workflows/labeler.yaml

@@ -60,7 +60,7 @@ jobs:
         if: env.review_needed == 'true' && steps.append_comment.outputs.previous_comment_id == ''
         env:
           SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL_DOCS }}
-          SLACK_WEBHOOK_TYPE: INCOMING_WEBHOOK
+          SLACK_WEBHOOK_TYPE: incoming_webhook
         with:
           payload: |
             {

docs/command/atlas-api-alertConfigurations-createAlertConfiguration.txt

@@ -51,7 +51,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-alertConfigurations-toggleAlertConfiguration.txt

@@ -58,7 +58,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-alertConfigurations-updateAlertConfiguration.txt

@@ -58,7 +58,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-alerts-acknowledgeAlert.txt

@@ -55,7 +55,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-atlasSearch-createAtlasSearchDeployment.txt

@@ -50,7 +50,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-atlasSearch-createAtlasSearchIndex.txt

@@ -52,7 +52,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-atlasSearch-createAtlasSearchIndexDeprecated.txt

@@ -52,7 +52,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-atlasSearch-updateAtlasSearchDeployment.txt

@@ -50,7 +50,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-atlasSearch-updateAtlasSearchIndex.txt

@@ -52,7 +52,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-atlasSearch-updateAtlasSearchIndexByName.txt

@@ -60,7 +60,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-atlasSearch-updateAtlasSearchIndexDeprecated.txt

@@ -52,7 +52,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-auditing-updateAuditingConfiguration.txt

@@ -48,7 +48,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-awsClustersDns-toggleAwsCustomDns.txt

@@ -48,7 +48,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-cloudBackups-createBackupExportJob.txt

@@ -52,7 +52,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-cloudBackups-createBackupRestoreJob.txt

@@ -55,7 +55,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-cloudBackups-createExportBucket.txt

@@ -48,7 +48,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-cloudBackups-createServerlessBackupRestoreJob.txt

@@ -55,7 +55,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-cloudBackups-takeSnapshot.txt

@@ -55,7 +55,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-cloudBackups-updateBackupSchedule.txt

@@ -52,7 +52,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-cloudBackups-updateDataProtectionSettings.txt

@@ -48,7 +48,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-cloudBackups-updateSnapshotRetention.txt

@@ -52,7 +52,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-cloudMigrationService-createLinkToken.txt

@@ -48,7 +48,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - -h, --help
      - 
      - false

docs/command/atlas-api-cloudMigrationService-createPushMigration.txt

@@ -54,7 +54,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-cloudMigrationService-validateMigration.txt

@@ -48,7 +48,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-cloudProviderAccess-authorizeCloudProviderAccessRole.txt

@@ -48,7 +48,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-cloudProviderAccess-createCloudProviderAccessRole.txt

@@ -48,7 +48,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-clusterOutageSimulation-startOutageSimulation.txt

@@ -50,7 +50,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-clusters-createCluster.txt

@@ -51,7 +51,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-clusters-grantMongoDbEmployeeAccess.txt

@@ -50,7 +50,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-clusters-pinFeatureCompatibilityVersion.txt

@@ -52,7 +52,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-clusters-updateCluster.txt

@@ -52,7 +52,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-clusters-updateClusterAdvancedConfiguration.txt

@@ -52,7 +52,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-clusters-upgradeSharedCluster.txt

@@ -51,7 +51,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-collectionLevelMetrics-pinNamespacesPatch.txt

@@ -50,7 +50,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-collectionLevelMetrics-pinNamespacesPut.txt

@@ -52,7 +52,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-collectionLevelMetrics-unpinNamespaces.txt

@@ -50,7 +50,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-customDatabaseRoles-createCustomDatabaseRole.txt

@@ -48,7 +48,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-customDatabaseRoles-updateCustomDatabaseRole.txt

@@ -48,7 +48,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-dataFederation-createDataFederationPrivateEndpoint.txt

@@ -75,7 +75,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-dataFederation-createFederatedDatabase.txt

@@ -48,7 +48,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-dataFederation-createOneDataFederationQueryLimit.txt

@@ -48,7 +48,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-dataFederation-updateFederatedDatabase.txt

@@ -48,7 +48,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true

docs/command/atlas-api-dataLakePipelines-createPipeline.txt

@@ -46,7 +46,7 @@ Options
    * - --file
      - string
      - false
-     - path to the file which contains the api request contents
+     - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both.
    * - --groupId
      - string
      - true