Bias Analysis
Detected Bias Types
windows_tools
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deploying ARM templates. While Azure CLI is cross-platform, the inclusion of Azure PowerShell examples (which are most commonly used on Windows) and the use of PowerShell syntax for all language pivots in the Azure PowerShell tab indicate a Windows bias. The PowerShell examples are given equal prominence to CLI, and there is no mention of Linux/macOS-specific shell usage (e.g., Bash, zsh), nor are there any Linux/macOS-specific troubleshooting notes or alternative instructions. The documentation does not explicitly state that PowerShell Core is available cross-platform, which may cause confusion for non-Windows users. Additionally, the use of Cloud Shell is mentioned, which is cross-platform, but the PowerShell tab may suggest Windows-first thinking.
Recommendations
- Clarify that Azure CLI commands work on Windows, Linux, and macOS, and recommend CLI for cross-platform usage.
- Explicitly state that PowerShell Core is available on Linux/macOS, or link to installation instructions for non-Windows users.
- Add Bash or zsh examples for Linux/macOS users, especially in the 'Deploy the template' section.
- Add troubleshooting notes or links for Linux/macOS users regarding shell differences and environment setup.
- Consider reordering examples to show Azure CLI (cross-platform) first and PowerShell second, or clearly indicate platform applicability.
Create Pull Request