Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI (Linux-friendly) and Azure PowerShell (Windows-centric) examples for most tasks, but often presents PowerShell examples first or with more detail. The deployment and management instructions (e.g., deploying the Bicep file) are shown only with Azure PowerShell, with no Linux/macOS equivalent (such as Azure CLI or Bash). ARMClient usage is shown only with PowerShell syntax. There is a lack of parity in step-by-step deployment instructions for Linux/macOS users, and PowerShell is frequently referenced as the default scripting and management tool.
Recommendations
- Add explicit Azure CLI or Bash examples for deploying Bicep files and managing deployment scripts, especially in sections currently showing only PowerShell commands.
- Present CLI and PowerShell examples side-by-side or alternate which is shown first, to avoid implicit prioritization.
- Clarify that both Azure CLI and PowerShell are supported on all platforms, and provide platform-agnostic instructions where possible.
- Include notes or links for Linux/macOS users on how to install and use Azure CLI for deployment tasks.
- Show ARMClient usage with CLI or REST examples, not just PowerShell.
Create Pull Request