Document Details
Api Version Retirement Sep 2023
❌
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:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
windows_tools
Summary:
The documentation page demonstrates a moderate Windows bias. Azure PowerShell is given equal prominence to Azure CLI, with explicit PowerShell commands and update instructions, while Linux-native tools or shell examples are not provided. The Azure CLI is mentioned, but no bash or Linux-specific guidance is included. The order of presentation often puts PowerShell before or alongside CLI, and Windows-centric tools (PowerShell, Azure portal) are emphasized. There are no explicit Linux shell or scripting examples, and the documentation assumes familiarity with Windows tools.
Recommendations:
- Provide Linux shell (bash) equivalents for all PowerShell commands, especially for checking and updating Azure CLI.
- Explicitly mention that Azure CLI is cross-platform and provide Linux/macOS installation and update instructions.
- When listing tools, consider mentioning cross-platform tools (CLI, Terraform, Bicep) before Windows-centric ones (PowerShell).
- Add examples or links for managing API Management via bash scripts or Linux automation tools.
- Clarify that the Azure portal and REST API are platform-agnostic, and highlight this in relevant sections.
Create pull request