Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation consistently provides both Azure CLI and Azure PowerShell examples for each query, but PowerShell is featured as a first-class option throughout, with variable assignment and usage examples that are distinctly PowerShell-centric (e.g., $subid = (Get-AzContext).Subscription.Id). There is no explicit mention of Linux-specific shell environments (such as bash, zsh, etc.), nor are there examples tailored to Linux users (e.g., using bash scripting, environment variables, or shell-specific quoting/escaping guidance). The documentation assumes parity between CLI and PowerShell, but the variable assignment and scripting examples are Windows/PowerShell-oriented, and PowerShell is listed before CLI in some places, suggesting a Windows-first approach.
Recommendations
- Add explicit Linux/bash examples for variable assignment and scripting (e.g., show how to use export, $(), and quoting/escaping in bash/zsh).
- Include notes or examples for common Linux shell environments, such as bash, zsh, or fish, especially where quoting or escaping is required.
- Ensure Azure CLI examples are as detailed as PowerShell ones, including variable usage and scripting patterns.
- Where PowerShell-specific patterns are shown, provide equivalent bash/Linux shell patterns side-by-side.
- Review ordering of examples to avoid listing PowerShell before CLI by default; consider listing CLI first or alternating order.
- Add troubleshooting notes for Linux users regarding shell differences, quoting, and environment setup.
Create Pull Request