Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and PowerShell examples for deploying Bicep files, but PowerShell (a Windows-centric tool) is consistently presented alongside CLI, sometimes with more detail. There is no mention of Linux-specific shell usage (e.g., Bash), nor any explicit Linux guidance. The order of examples sometimes places PowerShell after CLI, but both are given equal prominence, which may subtly reinforce Windows familiarity. No Linux-exclusive tools or patterns are discussed.
Recommendations
- Explicitly mention that Azure CLI commands work cross-platform (Windows, Linux, macOS) and provide example shell usage (e.g., Bash).
- Add notes or examples for running Azure CLI commands in Bash or other Linux shells, including any differences in quoting, line continuation, or environment setup.
- Clarify that PowerShell examples are primarily for Windows users, and suggest alternatives for Linux users (e.g., Bash, Zsh).
- Consider including a section on prerequisites or environment setup for Linux users, such as installing Azure CLI on Ubuntu.
- If possible, add troubleshooting tips or links for common Linux issues when using Bicep and Azure CLI.
Create Pull Request