Document Details
Upgrade And Scale
❌
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
missing_linux_example
Summary:
The documentation page exclusively describes how to upgrade and scale an Azure API Management instance using the Azure Portal UI, with no command-line examples or automation instructions. There are no references to Windows-specific tools, but there is also a complete absence of CLI-based instructions (such as Azure CLI, PowerShell, or Bash), which are important for Linux users and automation scenarios. This omission results in an implicit bias toward portal-based workflows, which are often associated with Windows-centric documentation, and does not provide parity for Linux users who may prefer or require CLI-based management.
Recommendations:
- Add step-by-step examples for scaling and upgrading using the Azure CLI (az apim commands), which work cross-platform on Linux, macOS, and Windows.
- If PowerShell examples are provided in the future, ensure equivalent Azure CLI or Bash examples are included and presented with equal prominence.
- Explicitly mention that all CLI instructions are cross-platform and do not require Windows.
- Include links to relevant Azure CLI documentation for API Management operations.
Create pull request