Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation consistently provides both Azure CLI and Azure PowerShell examples for each query, with PowerShell being a Windows-centric tool. In several places, PowerShell examples are given equal prominence to CLI, and in some cases, PowerShell-specific instructions (e.g., variable assignment) are included. There is no explicit mention of Linux-specific shell usage (e.g., Bash, Zsh), nor are there examples tailored to Linux environments, such as handling quoting or environment differences. The documentation assumes parity between CLI and PowerShell, but PowerShell is primarily a Windows tool, and its inclusion may signal a Windows bias, especially for new users. Additionally, installation instructions reference Azure PowerShell before Azure CLI in some places.
Recommendations
- Add explicit Bash/Zsh/Linux shell examples where CLI usage may differ (e.g., quoting, environment variables).
- Clarify that Azure CLI is cross-platform and provide Linux-specific notes for installation and usage.
- Where PowerShell examples are given, ensure that equivalent Bash/Linux shell scripting examples are also provided.
- Review the order of presentation: consider listing Azure CLI before PowerShell to reflect its cross-platform nature.
- Add troubleshooting notes for common Linux shell issues (e.g., escaping quotes, output formatting).
- Mention that PowerShell Core is available on Linux, but clarify differences if relevant.
Create Pull Request