Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides examples for Azure CLI, Azure PowerShell, and the Azure Portal. While Azure CLI is cross-platform, the inclusion of Azure PowerShell examples introduces a Windows bias, as PowerShell is historically a Windows-centric tool (despite recent cross-platform support). Additionally, the documentation lists Azure CLI first, followed by Azure PowerShell, which is a positive sign for parity, but the presence of PowerShell-specific examples may still signal a Windows preference. There are no Linux-specific shell examples (e.g., Bash scripts, curl, jq), nor is there mention of Linux-native tooling or usage patterns.
Recommendations
- Add Linux/Bash shell examples using Azure CLI, demonstrating output parsing with tools like jq or grep.
- Clarify that Azure CLI commands work on Linux, macOS, and Windows, and provide explicit instructions for installing and using CLI on Linux.
- If PowerShell is included, mention that PowerShell Core is available cross-platform and provide installation guidance for Linux users.
- Consider including sample scripts for Linux environments, such as Bash or Zsh, to show parity.
- Avoid implying that PowerShell is the default or preferred scripting environment unless justified by technical reasons.
Create Pull Request