Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all deployment and management steps. However, PowerShell examples are given equal prominence to CLI, and PowerShell is a Windows-centric tool. Additionally, references to PowerShell cmdlets (e.g., Get-AzActionGroup, Get-AzConsumptionBudget) and variable assignment patterns (using '@(...)' arrays) are specific to Windows/PowerShell environments. There is no mention of Linux-specific shell patterns (e.g., Bash arrays), nor are there examples tailored for Linux users. The documentation implicitly assumes familiarity with Windows tooling and does not address Linux-specific nuances.
Recommendations
- Add explicit Bash shell variable assignment examples for parameters, especially for arrays (e.g., using myContactEmails=("user1@contoso.com" "user2@contoso.com") and passing them to Azure CLI).
- Clarify that Azure CLI commands work cross-platform and provide guidance for Linux/macOS users, including any differences in quoting or variable usage.
- Where PowerShell cmdlets are referenced (e.g., Get-AzActionGroup), also mention the equivalent Azure CLI command (already partially done, but could be more explicit).
- Consider reordering examples to present Azure CLI (cross-platform) before PowerShell (Windows-centric), or explicitly state that CLI is recommended for Linux/macOS.
- Add a note or section addressing Linux/macOS users, highlighting any OS-specific considerations for running Bicep deployments and managing resources.
Create Pull Request