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 presents Azure PowerShell examples before Azure CLI examples in all relevant sections, and references to PowerShell cmdlets are repeated even in CLI sections. This ordering and emphasis can be perceived as a Windows-first and PowerShell-heavy bias, as Linux users are more likely to use Azure CLI or Bash. However, the documentation does provide Azure CLI examples and does not exclusively use Windows tools.
Recommendations:
- Alternate the order of PowerShell and CLI examples, or present CLI examples first in some sections to better reflect cross-platform usage.
- In CLI sections, avoid referencing PowerShell cmdlets (e.g., for viewing registration status, use 'az feature show' instead of 'Get-AzProviderFeature').
- Explicitly mention that both PowerShell and CLI are cross-platform, and provide Bash script examples where relevant.
- Add a short note or table at the beginning clarifying that all operations can be performed on Windows, Linux, or macOS, and link to platform-specific installation guides for Azure CLI and PowerShell.
- Where possible, include ARM/Bicep/Terraform examples alongside imperative commands to further increase platform neutrality.
Create pull request