Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell instructions for deploying Bicep files, but consistently lists Azure PowerShell examples immediately after Azure CLI, without mentioning Linux/macOS shell alternatives (e.g., Bash, zsh) or clarifying that PowerShell is primarily a Windows tool. There are no Linux/macOS-specific instructions or examples, and PowerShell is presented as an equal alternative, which may create friction for non-Windows users unfamiliar with PowerShell.
Recommendations
- Clarify that Azure PowerShell is primarily for Windows users, and that Azure CLI commands work in Bash/zsh on Linux/macOS.
- Explicitly mention that Azure CLI commands are cross-platform and can be run in Bash, zsh, or Windows Command Prompt.
- Consider providing example commands in Bash/zsh for Linux/macOS users, or add a note stating that Azure CLI commands are suitable for those platforms.
- If PowerShell is not required for any step, consider omitting it or moving it after CLI examples to reduce perceived Windows-first bias.
Create Pull Request