Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation consistently provides Azure PowerShell examples alongside Azure CLI and portal instructions. PowerShell is a Windows-centric tool, and its inclusion in every example (often before or alongside CLI) may signal a Windows bias. There are no explicit Linux shell (bash, zsh, etc.) examples, nor are Linux-specific usage notes or troubleshooting tips provided. The CLI examples are cross-platform, but the lack of explicit Linux shell context or parity (e.g., scripting, environment variables, authentication differences) means Linux users may not feel fully supported.
Recommendations
- Add explicit bash/zsh shell examples for each scenario, showing how to use az CLI in Linux environments (including environment variable usage, piping, and output parsing).
- Include notes on authentication and installation differences for Linux users (e.g., az CLI installation via apt/yum, differences in credential storage).
- Where PowerShell is mentioned, clarify that it is available cross-platform, but also provide Linux-native alternatives (e.g., bash scripts, jq for JSON parsing).
- Add troubleshooting or FAQ sections for common Linux issues (e.g., permissions, path differences, dependency installation).
- Consider reordering examples to present CLI (cross-platform) first, followed by PowerShell, to emphasize platform neutrality.
Create Pull Request