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:
Summary:
The documentation provides both Azure CLI and Azure PowerShell examples for querying availability zone mappings, but the PowerShell example is presented immediately after the CLI example, and both are given equal prominence. There are no Linux-specific tools or shell (e.g., Bash) examples, but the Azure CLI is cross-platform. There is a slight 'windows_first' bias in that PowerShell is featured as the only alternative to the CLI, and no explicit mention is made of Linux-native scripting or tools.
Recommendations:
- Explicitly mention that Azure CLI is cross-platform and works on Linux, macOS, and Windows.
- Consider providing a Bash shell example (using curl/jq) for Linux users to query the REST API, in addition to the Azure CLI and PowerShell examples.
- Clarify in the documentation that PowerShell examples are primarily for Windows users, while CLI and Bash are suitable for Linux.
- Where possible, provide command-line examples in the order: Azure CLI (cross-platform), Bash (Linux/macOS), then PowerShell (Windows), to avoid implicit Windows-first ordering.
Create pull request