Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all steps, but PowerShell is given equal prominence as CLI, and PowerShell is a Windows-centric tool. There are no Linux/macOS-specific shell examples (e.g., Bash), and PowerShell examples may not be directly usable for Linux/macOS users who do not have PowerShell Core installed. The documentation does not mention Linux-specific considerations or tools, and PowerShell is presented as a primary method alongside CLI, which may create friction for non-Windows users.
Recommendations
- Clarify that Azure CLI commands are cross-platform and recommend them as the default for Linux/macOS users.
- Add explicit Bash shell variable assignment examples for Linux/macOS users (e.g., myActions='["Microsoft.Resources/subscriptions/resourceGroups/read"]').
- Note that PowerShell examples require PowerShell Core on Linux/macOS and provide installation guidance or links.
- Consider listing Azure CLI examples first to emphasize cross-platform compatibility.
- Add a brief section on platform compatibility for each tool, helping users choose the best option for their OS.
Create Pull Request