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:
⚠️
windows_first
⚠️
powershell_heavy
Summary:
The documentation page demonstrates a mild Windows bias in the section describing how to enumerate available 'list' operations for resources. The PowerShell (Windows-centric) example is presented before the Azure CLI example, and the PowerShell cmdlet is specifically highlighted. No Linux-specific or cross-platform shell examples (such as Bash or scripting with jq) are provided. However, the majority of the documentation is platform-agnostic, focusing on Bicep syntax and Azure concepts.
Recommendations:
- Present Azure CLI examples before PowerShell examples, as Azure CLI is cross-platform and more widely used on Linux and macOS.
- Explicitly mention that both Azure CLI and PowerShell are supported on all major platforms, but Azure CLI is the default for Linux/macOS users.
- Where possible, provide Bash or shell scripting examples (e.g., using jq to parse JSON output from Azure CLI) to further support Linux users.
- Add a note or section clarifying that all command-line examples are cross-platform unless otherwise stated, and provide links to installation instructions for both Azure CLI and PowerShell.
- Consider including a table or callout that summarizes equivalent commands in Azure CLI, PowerShell, and Bash for common operations.
Create pull request