Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and PowerShell examples for deploying ARM templates at the subscription scope. However, PowerShell examples are given equal prominence and detail as Azure CLI, despite PowerShell being primarily a Windows tool. There are no explicit Linux/macOS shell examples (e.g., Bash), and PowerShell is presented as a default option alongside CLI, which may create friction for Linux/macOS users. Additionally, the documentation refers to PowerShell-specific commands and patterns without noting cross-platform alternatives or clarifying that PowerShell Core is available on Linux/macOS.
Recommendations
- Clarify that Azure CLI is fully cross-platform and highlight it as the recommended option for Linux/macOS users.
- Add explicit Bash shell examples for Azure CLI commands to demonstrate usage on Linux/macOS.
- Note that PowerShell Core is available on Linux/macOS, but most Linux users prefer Bash/CLI.
- Present Azure CLI examples before PowerShell, or group them by platform (Windows vs. Linux/macOS).
- Avoid implying parity between PowerShell and CLI for all platforms; clarify platform-specific guidance.
Create Pull Request