Unify flags for machine part

Author: JessamyT

docs/dev/tools/cli.md

@@ -280,29 +280,29 @@ The `dataset` command allows you to manage machine data in datasets.
 With it, you can add or remove images from a dataset, export data from a dataset, or filter a dataset by tags.
 
 ```sh {class="command-line" data-prompt="$"}
-viam dataset create --org-id=<org-id> --name=<name>
+viam dataset create --org=<org-id> --name=<name>
 viam dataset rename --dataset-id=<dataset-id> --name=<name>
-viam dataset list --org-id=<org-id>
+viam dataset list --org=<org-id>
 viam dataset list --dataset-ids=<dataset-ids>
 viam dataset delete --dataset-id=<dataset-id>
 viam dataset export --destination=<output-directory> --dataset-id=<dataset-id>
 viam dataset data add filter --dataset-id=<dataset-id> [...named args]
 viam dataset data remove filter --dataset-id=<dataset-id> [...named args]
-viam dataset data add ids --dataset-id=<dataset-id> --org-id=<org-id> --location-id=<location-id> --file-ids=<file-ids>
-viam dataset data remove ids --dataset-id=<dataset-id> --org-id=<org-id> --location-id=<location-id> --file-ids=<file-ids>
+viam dataset data add ids --dataset-id=<dataset-id> --org=<org-id> --location-id=<location-id> --file-ids=<file-ids>
+viam dataset data remove ids --dataset-id=<dataset-id> --org=<org-id> --location-id=<location-id> --file-ids=<file-ids>
 ```
 
 Examples:
 
 ```sh {class="command-line" data-prompt="$"}
 # create a new dataset
-viam dataset create --org-id=123 --name=MyDataset
+viam dataset create --org=123 --name=MyDataset
 
 # rename dataset 123 from MyDataset to MyCoolDataset
 viam dataset rename --dataset-id=123 --name=MyCoolDataset
 
 # list dataset information from the specified org
-viam dataset list --org-id=123
+viam dataset list --org=123
 
 # list dataset information from the specified dataset ids
 viam dataset list --dataset-ids=123,456
@@ -354,8 +354,8 @@ viam dataset data remove ids --dataset-id= abc --org-id=123 --location-id=456 --
 <!-- prettier-ignore -->
 | Argument | Description | Applicable commands | Required? |
 | -------- | ----------- | ------------------- | --------- |
-| `--dataset-id` | Dataset to perform an operation on. To retrieve the ID, navigate to your dataset’s page in the [Viam app](https://app.viam.com), click **…** in the left-hand menu, and click **Copy dataset ID** | `rename`, `delete`, `data add`, `data remove`, `export` | **Required** |
-| `--dataset-ids` | Dataset IDs of datasets to be listed. To retrieve these IDs, navigate to your dataset’s page in the [Viam app](https://app.viam.com), click **…** in the left-hand menu, and click **Copy dataset ID** | `list` | Optional |
+| `--dataset-id` | Dataset to perform an operation on. To retrieve the ID, navigate to your dataset's page in the [Viam app](https://app.viam.com), click **…** in the left-hand menu, and click **Copy dataset ID** | `rename`, `delete`, `data add`, `data remove`, `export` | **Required** |
+| `--dataset-ids` | Dataset IDs of datasets to be listed. To retrieve these IDs, navigate to your dataset's page in the [Viam app](https://app.viam.com), click **…** in the left-hand menu, and click **Copy dataset ID** | `list` | Optional |
 | `--destination` | Output directory for downloaded data | `export` | **Required** |
 | `--end` | ISO-8601 timestamp indicating the end of the interval | `data add`, `data remove` | Optional |
 | `--file-ids` | The file-ids of the files to perform an operation on | `data add`, `data remove`, `export` | **Required** |
@@ -437,10 +437,10 @@ With it, you can export data in a variety of formats, delete specified data, add
 viam data export binary --destination=<output path> [...named args]
 viam data export tabular --destination=<destination> --part-id=<part-id> --resource-name=<resource-name> --resource-subtype=<resource-subtype> --method=<method> [other options]
 viam data delete --org-ids=<org-ids> --start=<timestamp> --end=<timestamp> [...named args]
-viam data database configure --org-id=<org-id> --password=<db-user-password>
-viam data database hostname --org-id=<org-id>
-viam data tag ids add --tags=<tags> --org-id=<org_id> --location-id=<location_id> --file-ids=<file_ids>
-viam data tag ids remove --tags=<tags> --org-id=<org_id> --location-id=<location_id> --file-ids=<file_ids>
+viam data database configure --org=<org-id> --password=<db-user-password>
+viam data database hostname --org=<org-id>
+viam data tag ids add --tags=<tags> --org=<org_id> --location-id=<location_id> --file-ids=<file_ids>
+viam data tag ids remove --tags=<tags> --org=<org_id> --location-id=<location_id> --file-ids=<file_ids>
 viam data tag filter add --tags=<tags> [...named args from filter]
 viam data tag filter remove --tags=<tags> [...named args from filter]
 ```
@@ -459,16 +459,16 @@ viam data delete binary --org-ids=123 --mime-types=image/jpeg --start 2024-08-20
 
 # configure a database user for the Viam organization's MongoDB Atlas Data
 # Federation instance, in order to query tabular data
-viam data database configure --org-id=abc --password=my_password123
+viam data database configure --org=<org-id> --password=my_password123
 
 # get the hostname to access a MongoDB Atlas Data Federation instance
-viam data database hostname --org-id=abc
+viam data database hostname --org=<org-id>
 
 # add tags to all data that matches the given ids
-viam data tag ids add --tags=new_tag_1,new_tag_2,new_tag_3 --org-id=123 --location-id=123 --file-ids=123,456
+viam data tag ids add --tags=new_tag_1,new_tag_2,new_tag_3 --org=123 --location-id=123 --file-ids=123,456
 
 # remove tags from all data that matches the given ids
-viam data tag ids remove --tags=new_tag_1,new_tag_2,new_tag_3 --org-id=123 --location-id=123 --file-ids=123,456
+viam data tag ids remove --tags=new_tag_1,new_tag_2,new_tag_3 --org=123 --location-id=123 --file-ids=123,456
 
 # add tags to all data that matches a given filter
 viam data tag filter add --tags=new_tag_1,new_tag_2 --location-ids=012 --machine-name=cool-machine --org-ids=84842  --mime-types=image/jpeg,image/png
@@ -1229,15 +1229,15 @@ This includes:
 
 ```sh {class="command-line" data-prompt="$"}
 viam machines list
-viam machines status --organization=<org name> --location=<location name> --machine=<machine id>
-viam machines logs --organization=<org name> --location=<location name> --machine=<machine id> [...named args]
-viam machines api-key create --machine-id=<machine-id> [...named args]
+viam machines status --org=<org name> --location=<location name> --machine=<machine id>
+viam machines logs --org=<org name> --location=<location name> --machine=<machine id> [...named args]
+viam machines api-key create --machine=<machine-id> [...named args]
 viam machines part logs --machine=<machine> --part=<part> [...named args]
-viam machines part status --organization=<org name> --location=<location name> --machine=<machine id>
-viam machines part run --organization=<org name> --location=<location name> --machine=<machine id> [--stream] --data <meth>
-viam machines part shell --organization=<org name> --location=<location name> --machine=<machine id> --part=<part id>
+viam machines part status --org=<org name> --location=<location name> --machine=<machine id>
+viam machines part run --org=<org name> --location=<location name> --machine=<machine id> [--stream] --data <meth>
+viam machines part shell --org=<org name> --location=<location name> --machine=<machine id> --part=<part id>
 viam machines part restart --machine=<machine id> --part=<part id>
-viam machines part cp --organization=<org name> --location=<location name> --machine=<machine id> --part=<part name> <file name> machine:/path/to/file
+viam machines part cp --org=<org name> --location=<location name> --machine=<machine id> --part=<part name> <file name> machine:/path/to/file
 ```
 
 Examples:
@@ -1250,7 +1250,7 @@ viam machines list
 viam machines status  --machine=123
 
 # create an api key for a machine
-viam machines api-key create --machine-id=123 --name=MyKey
+viam machines api-key create --machine=123 --name=MyKey
 
 # stream logs from a machine
 viam machines logs --machine=123
@@ -1323,9 +1323,9 @@ viam machine part cp --part=123 -r -p machine:my_dir machine:my_file ~/some/exis
 <!-- prettier-ignore -->
 | Argument | Description | Applicable commands | Required? |
 | -------- | ----------- | ------------------- | --------- |
-| `--organization` | Organization name or ID that the machine belongs to | `list`, `status`, `logs`, `part` | Optional |
+| `--org` | Organization name or ID that the machine belongs to | `list`, `status`, `logs`, `part` | Optional |
 | `--location` | Location name or ID that the machine belongs to or to list machines in | `list`, `status`, `logs`, `part` | Optional |
-| `--machine` | Machine name or ID for which the command is being issued. If machine name is used instead of ID, `--organization` and `--location` are required. | `status`, `logs`, `part` | Optional |
+| `--machine` | Machine name or ID for which the command is being issued. If machine name is used instead of ID, `--org` and `--location` are required. | `status`, `logs`, `part` | Optional |
 | `--errors` | Boolean, return only errors (default: false) | `logs` | Optional |
 | `--levels` | Filter logs by levels (debug, info, warn, error). Accepts multiple inputs in comma-separated list. | `logs` | Optional |
 | `--part` | Part name or ID for which the command is being issued | `logs`, `part` | Optional |
@@ -1375,18 +1375,18 @@ The `--stream` argument, when included in the CLI command prior to the `--data`
 Manage training scripts for [custom ML training](/data-ai/ai/train/).
 
 ```sh {class="command-line" data-prompt="$"}
-viam training-script upload --framework=<framework> --org-id=<org-id> --path=<path-to-script> --script-name=<script-name> --type=<type>
-viam training-script update --org-id=<org-id> --script-name=<script-name> --visibility=<visibility>
+viam training-script upload --framework=<framework> --org=<org-id> --path=<path-to-script> --script-name=<script-name> --type=<type>
+viam training-script update --org=<org-id> --script-name=<script-name> --visibility=<visibility>
 ```
 
 Examples:
 
 ```sh {class="command-line" data-prompt="$"}
 # upload a single label classification script in the tflite framework to organization 123
-viam training-script upload --framework=tflite --org-id=123 --path=. --script-name=MyCustomTrainingScript --type=single_label_classification
+viam training-script upload --framework=tflite --org=123 --path=. --script-name=MyCustomTrainingScript --type=single_label_classification
 
 # update MyCustomTrainingScript with public visibility
-viam training-script update --org-id=123 --script-name=MyCustomTrainingScript --visibility=public --description="A single label classification training script"
+viam training-script update --org=123 --script-name=MyCustomTrainingScript --visibility=public --description="A single label classification training script"
 ```
 
 #### Command options