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 and detail as Azure CLI, and are presented in dedicated sections. There is no explicit mention of Linux/macOS environments, nor are there examples showing Linux-specific shell usage (e.g., bash, zsh), nor any discussion of platform differences. The documentation assumes that Azure CLI and PowerShell are equally available and familiar to all users, which is not the case for many Linux/macOS users, as PowerShell is less commonly used or installed by default. Additionally, the ordering of examples sometimes places PowerShell before or alongside CLI, rather than prioritizing CLI for cross-platform parity.
Recommendations
- Explicitly state that Azure CLI is cross-platform and available on Linux/macOS, while PowerShell may require additional installation on those platforms.
- Provide Linux/macOS-specific CLI examples (e.g., bash syntax for environment variables, quoting, and parameter passing).
- Add notes or links for installing Azure CLI and PowerShell on Linux/macOS, clarifying platform support.
- Prioritize Azure CLI examples before PowerShell, or clearly mark PowerShell as Windows-centric.
- Include troubleshooting tips for common Linux/macOS issues (e.g., file permissions, shell quoting).
Create Pull Request