Document supported CLI environment variables

Author: Copilot

docs/commands/extract.md

@@ -75,6 +75,7 @@ apiops extract \
 | `--subscription-id <id>` | string | env: `AZURE_SUBSCRIPTION_ID` | Azure subscription ID (required) |
 | `--log-level <level>` | string | `info` | Log level: `debug`, `info`, `warn`, `error` |
 | `--format <type>` | string | `text` | Output format: `text` or `json` |
+| `--api-version <version>` | string | `2024-05-01` (env: `AZURE_API_VERSION`) | APIM REST API version override |
 | `--cloud <name>` | string | `public` | Sovereign cloud: `public`, `china`, `usgov`, `germany` |
 | `--client-id <id>` | string | — | Service principal client ID |
 | `--client-secret <secret>` | string | — | Service principal client secret |

docs/commands/publish.md

@@ -86,6 +86,7 @@ apiops publish \
 | `--subscription-id <id>` | string | env: `AZURE_SUBSCRIPTION_ID` | Azure subscription ID (required) |
 | `--log-level <level>` | string | `info` | Log level: `debug`, `info`, `warn`, `error` |
 | `--format <type>` | string | `text` | Output format: `text` or `json` |
+| `--api-version <version>` | string | `2024-05-01` (env: `AZURE_API_VERSION`) | APIM REST API version override |
 | `--cloud <name>` | string | `public` | Sovereign cloud: `public`, `china`, `usgov`, `germany` |
 | `--client-id <id>` | string | — | Service principal client ID |
 | `--client-secret <secret>` | string | — | Service principal client secret |
@@ -162,6 +163,8 @@ In CI/CD pipelines, this is typically set automatically:
 - run: npx apiops publish --commit-id ${{ github.event.before }}
 ```
 
+When both are provided, `--commit-id` takes precedence over `COMMIT_ID`.
+
 > **Tip:** Incremental publish cannot be combined with `--delete-unmatched` because delete-unmatched requires a full comparison between source and APIM.
 
 ## Dry run

docs/reference/configuration.md

@@ -88,6 +88,8 @@ Available on all commands (`extract`, `publish`, `init`):
 | `AZURE_TENANT_ID` | all | Microsoft Entra ID (Azure AD) tenant ID |
 | `AZURE_API_VERSION` | extract, publish | APIM REST API version (default: `2024-05-01`) |
 | `COMMIT_ID` | publish | Git commit SHA for incremental publish (alternative to `--commit-id`) |
+| `OTEL_EXPORTER_OTLP_ENDPOINT` | extract, publish | OpenTelemetry OTLP exporter endpoint for telemetry |
+| `APPLICATIONINSIGHTS_CONNECTION_STRING` | extract, publish | Azure Monitor Application Insights connection string for telemetry |
 
 ### Authentication Environment Variables