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 level. However, PowerShell examples are given equal prominence to Azure CLI, and in some sections, PowerShell is presented immediately after CLI. There is no explicit mention of Linux/macOS environments, nor are there any examples or notes about platform-specific differences. The use of PowerShell (which is traditionally associated with Windows, though now cross-platform) may create friction for Linux/macOS users, especially since no Bash or shell script examples are provided, and no guidance is given for Linux-specific nuances (e.g., quoting, environment variables).
Recommendations
- Explicitly state that Azure CLI works cross-platform (Windows, Linux, macOS) and is recommended for non-Windows users.
- Provide Bash/shell script examples for Linux/macOS users, especially for parameter passing and environment variable usage.
- Add notes or tips about running PowerShell on Linux/macOS, including installation links if PowerShell is required.
- Where possible, show CLI examples before PowerShell, or clarify that CLI is platform-neutral.
- Mention Azure Cloud Shell as a platform-independent option for running both CLI and PowerShell commands.
Create Pull Request