Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deploying Bicep files, but the PowerShell example is given equal prominence to the CLI example, and there is no explicit mention of Linux/macOS environments or shell-specific considerations. The CLI example is cross-platform, but the PowerShell example is Windows-centric. There are no bash or Linux-specific examples, nor any mention of running these commands in a Linux shell or Cloud Shell (except in a link). This may subtly reinforce a Windows-first or PowerShell-heavy bias.
Recommendations
- Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and can be run from Bash, PowerShell, or Cloud Shell.
- Add example commands for Bash (Linux/macOS) environments, especially for common deployment scenarios.
- Clarify that PowerShell examples are primarily for Windows users, and suggest using Azure CLI for cross-platform compatibility.
- Consider reordering examples to present Azure CLI (cross-platform) before PowerShell, or group them under 'Windows' and 'Linux/macOS' headings.
- Add notes or links to documentation about using Bicep deployments from Linux/macOS terminals.
Create Pull Request