chore(docs): update description of --output option (#1994)

Author: jeremyfiel

.changeset/spotty-maps-grab.md

@@ -0,0 +1,6 @@
+---
+"@redocly/cli": patch
+"@redocly/respect-core": patch
+---
+
+Updated `output` flag docs for `generate-arazzo` command.

docs/commands/generate-arazzo.md

@@ -35,19 +35,19 @@ npx @redocly/cli generate-arazzo <your-OAS-description-file> [-o | --output-file
 
 - -o, --output-file
 - string
-- Path to the OAS description file. If the file name is not provided, the default name is used - `auto-generate.arazzo.yaml`. Example: `npx @redocly/cli generate-arazzo OAS-file.yaml -o=example.arazzo.yaml`
+- Name for the generated output file. Defaults to `auto-generated.arazzo.yaml` **If the file already exists, it's overwritten.** See the [specify output file](#specify-output-file) section.
 
 {% /table %}
 
 ## Examples
 
 Run the command: `npx @redocly/cli generate-arazzo 'https://warp-single-sidebar.redocly.app/_spec/apis/index.yaml'`
 
-The command generates a `auto-generate.arazzo.yaml` file in the current directory.
+The command generates an `auto-generated.arazzo.yaml` file in the current directory.
 
 The contents of the generated file are:
 
-```yaml {% title="auto-generate.arazzo.yaml" %}
+```yaml {% title="auto-generated.arazzo.yaml" %}
 arazzo: 1.0.1
 info:
   title: Warp API
@@ -115,6 +115,14 @@ workflows:
 
 The generated file is not a complete test file and needs to be extended to be functional.
 
+### Specify output file
+
+By default, the CLI tool writes the generated file as `auto-generated.arazzo.yaml` in the current working directory. Use the optional `--output` argument to provide an alternative output file path.
+
+```bash Command
+redocly generate-arazzo <your-OAS-description-file> --output=arazzo-custom.yaml
+```
+
 ## Resources
 
 - [Learn more about Arazzo](/learn/arazzo/what-is-arazzo).