Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation consistently presents PowerShell examples alongside Azure CLI and portal instructions, with PowerShell often mentioned before Azure CLI. PowerShell is a Windows-centric tool, and no Linux-specific shell examples (e.g., Bash, zsh) or platform notes are provided. There is no mention of Linux-specific considerations, nor are alternative Linux-native tools or scripting patterns discussed. This creates a subtle bias toward Windows users and workflows.
Recommendations
- Add explicit Bash examples for Azure CLI commands, showing usage in Linux/macOS terminals (e.g., with environment variables, piping, jq for JSON parsing).
- Include notes clarifying that Azure CLI works cross-platform, and provide examples of command usage in Linux shells.
- Where PowerShell is used, clarify that PowerShell Core is available on Linux/macOS, or provide equivalent Bash commands for property extraction.
- Consider mentioning Linux-native tools (e.g., curl for REST API calls, jq for JSON parsing) in relevant sections.
- Reorder examples so that Azure CLI (cross-platform) is presented before PowerShell, or present both equally.
Create Pull Request