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 PowerShell examples are given equal prominence to CLI and are included in every deployment section. There is a subtle Windows bias in the inclusion and visibility of Azure PowerShell, which is primarily a Windows tool, while no Linux/macOS-specific shell examples (such as Bash or zsh) are provided. However, the Azure CLI examples are cross-platform and shown first in each section, mitigating the impact.
Recommendations
- Clarify that Azure CLI commands work on Windows, Linux, and macOS, and are the recommended cross-platform approach.
- Consider moving Azure PowerShell examples to a separate tab or section labeled 'Windows/PowerShell', making it clear that it is optional for Windows users.
- Add a note for Linux/macOS users confirming that Azure CLI is fully supported on those platforms.
- Optionally, provide Bash script examples for common tasks to further improve parity.
Create Pull Request