Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deploying Bicep files at the management group scope. However, PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI, and is presented immediately after the CLI example. There are no explicit Linux-specific instructions or examples, and no mention of Bash scripting or Linux shell patterns. The documentation does not mention any platform-specific prerequisites or differences, but the inclusion of PowerShell as a primary example may signal a bias toward Windows users.
Recommendations
- Clearly indicate that Azure CLI is fully cross-platform and works on Windows, Linux, and macOS.
- Consider presenting Azure CLI examples first, as it is the most platform-agnostic tool.
- Add explicit Bash shell examples or notes for Linux users where relevant (e.g., environment variables, file paths).
- Clarify that PowerShell Core is available cross-platform, but note any differences if applicable.
- Include a brief section or note on running these commands in Linux/macOS environments, such as using Azure CLI in Bash or Zsh.
- Avoid implying that PowerShell is the default or preferred method unless there is a technical reason.
Create Pull Request