docs: update respect server option docs (#2034)

Author: DmitryAnansky

docs/commands/respect.md

@@ -27,7 +27,10 @@ npx @redocly/cli@latest respect <your-test-file | multiple files | files bash qu
 - -w, --workflow
 - [string]
 - Workflow names from the test file to run.
-  For example, the following command runs "first-flow" and "second-flow" workflows from the `test-file.yaml` Arazzo description: `npx @redocly/cli@latest respect test-file.yaml --workflow first-flow second-flow`.
+  For example, the following command runs "first-flow" and "second-flow" workflows from the `test-file.yaml` Arazzo description:
+
+  `npx @redocly/cli@latest respect test-file.yaml --workflow first-flow second-flow`
+
   {% admonition type="warning" %}
   The `--workflow` option can't be used with `--skip`.
   {% /admonition %}
@@ -37,7 +40,10 @@ npx @redocly/cli@latest respect <your-test-file | multiple files | files bash qu
 - -s, --skip
 - [string]
 - Workflow names from the test file to skip.
-  For example, the following command skips the "first-flow" workflow from the `test-file.yaml` Arazzo description: `npx @redocly/cli@latest respect test-file.yaml --skip first-flow`.
+  For example, the following command skips the "first-flow" workflow from the `test-file.yaml` Arazzo description:
+
+  `npx @redocly/cli@latest respect test-file.yaml --skip first-flow`
+
   {% admonition type="warning" name="Warning" %}
   The `--skip` option can't be used with `--workflow`.
   {% /admonition %}
@@ -47,41 +53,60 @@ npx @redocly/cli@latest respect <your-test-file | multiple files | files bash qu
 - -v, --verbose
 - boolean
 - Runs the command in verbose mode to help with troubleshooting issues.
-  For example, the following command runs all workflows from the `test-file.yaml` Arazzo description in verbose mode: `npx @redocly/cli@latest respect test-file.yaml --verbose`.
+  For example, the following command runs all workflows from the `test-file.yaml` Arazzo description in verbose mode:
+
+  `npx @redocly/cli@latest respect test-file.yaml --verbose`
 
 ---
 
 - --har-output
 - string
 - Path for the `har` file for saving logs.
-  For example, the following command runs all workflows from the `test-file.yaml` Arazzo description and saves the logs to the `logs.har` file: `npx @redocly/cli@latest respect test-file.yaml --har-output='logs.har'`.
+  For example, the following command runs all workflows from the `test-file.yaml` Arazzo description and saves the logs to the `logs.har` file:
+
+  `npx @redocly/cli@latest respect test-file.yaml --har-output='logs.har'`
 
 ---
 
 - --json-output
 - string
-- Path for the JSON file for saving logs. For example, the following command runs all workflows from the `test-file.yaml` Arazzo description and saves the logs to the `logs.json` file:`npx @redocly/cli@latest respect test-file.yaml --json-output='logs.json'`.
+- Path for the JSON file for saving logs. For example, the following command runs all workflows from the `test-file.yaml` Arazzo description and saves the logs to the `logs.json` file:
+
+  `npx @redocly/cli@latest respect test-file.yaml --json-output='logs.json'`
 
 ---
 
 - --input
 - string
 - Input parameters with values that are mapped to the workflow inputs description.
-  For example, the following command maps the "userEmail" and "userPassword" inputs and values to all workflows in the `test.yaml` Arazzo description: `npx @redocly/cli@latest respect test.yaml --input [email protected] --input userPassword=12345`.
-  You can also use an environment variable to set the input, as in the following example: `REDOCLY_CLI_RESPECT_INPUT='[email protected],userPassword=12345' npm run cli respect test.yaml`
+  For example, the following command maps the "userEmail" and "userPassword" inputs and values to all workflows in the `test.yaml` Arazzo description:
+
+  `npx @redocly/cli@latest respect test.yaml --input [email protected] --input userPassword=12345`
 
-  You can even include nested values, as in the following example command that maps the `nestedKey` input and value to all workflows in the `test-file.yaml` Arazzo description: `npx @redocly/cli@latest respect test-file.yaml --input '{"key": "value", "nested": {"nestedKey": "nestedValue"}}'`.
-  You can also use an environment variable to set the input, as in the following example: `REDOCLY_CLI_RESPECT_INPUT='{"key":"value","nested":{"nestedKey":"nestedValue"}}' npx @redocly/cli@latest respect test-file.yaml`
+  You can also use an environment variable to set the input, as in the following example:
+
+  `REDOCLY_CLI_RESPECT_INPUT='[email protected],userPassword=12345' npm run cli respect test.yaml`
+
+  You can even include nested values, as in the following example command that maps the `nestedKey` input and value to all workflows in the `test-file.yaml` Arazzo description:
+
+  `npx @redocly/cli@latest respect test-file.yaml --input '{"key": "value", "nested": {"nestedKey": "nestedValue"}}'`
+
+  You can also use an environment variable to set the input, as in the following example:
+
+  `REDOCLY_CLI_RESPECT_INPUT='{"key":"value","nested":{"nestedKey":"nestedValue"}}' npx @redocly/cli@latest respect test-file.yaml`
 
 ---
 
 - --server
 - string
 - Server overrides for the `sourceDescriptions` object.
-  For example, the following command runs all workflows from the `test-file.yaml` Arazzo description and instead of using the server listed in the API description, uses the server at `https://test.com`: `npx @redocly/cli@latest respect test-file.yaml --server test=https://test.com`.
+  For example, the following command runs all workflows from the `test-file.yaml` Arazzo description and instead of using the servers listed in the API description, uses the specified servers:
+
+  `npx @redocly/cli@latest respect test-file.yaml --server sourceDescriptionName1=https://test.com --server sourceDescriptionName2=https://test2.com`
 
-  You can also pass the server overrides as an environment variable, as in the following example:
-  `REDOCLY_CLI_RESPECT_SERVER="test=https://test.com"`.
+  You can also pass multiple server overrides as an environment variable by separating them with commas, as in the following example:
+
+  `REDOCLY_CLI_RESPECT_SERVER="sourceDescriptionName1=https://test.com,sourceDescriptionName2=https://test2.com"`
 
 ---
 
@@ -113,7 +138,8 @@ npx @redocly/cli@latest respect <your-test-file | multiple files | files bash qu
   {% /admonition %}
 
   For example, the following command sets status code errors to the warning severity level:
-  `npx @redocly/cli respect test-file.yaml --severity='{"STATUS_CODE_CHECK":"warn"}'`.
+
+  `npx @redocly/cli respect test-file.yaml --severity='{"STATUS_CODE_CHECK":"warn"}'`
 
 {% /table %}