Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a moderate Windows bias. While it acknowledges Azure CLI and Linux support, PowerShell examples and tooling are frequently presented first or exclusively, and deployment/management instructions are PowerShell-centric. There is a lack of parity in showing Linux/macOS terminal commands for deploying Bicep files, and PowerShell tools are referenced more often than their CLI equivalents.
Recommendations
- Provide Linux/macOS shell (bash) examples for deploying Bicep files, using Azure CLI (e.g., az deployment group create).
- Ensure that Azure CLI examples are presented before or alongside PowerShell examples, especially in deployment and management sections.
- Add explicit instructions for Linux/macOS users, including prerequisites and environment setup.
- Where PowerShell scripts are shown, offer equivalent bash/CLI commands.
- Clarify that Azure CLI and PowerShell are both supported and highlight any platform-specific limitations.
Create Pull Request