Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page exhibits Windows bias by consistently presenting PowerShell examples and references before Azure CLI equivalents, and by providing detailed PowerShell scripts for filtering and formatting output. The use of Windows-style file paths (e.g., .\sku-list.json) and exclusive mention of PowerShell cmdlets further reinforces the bias. Linux-specific patterns, shell scripting, or file path conventions are not addressed, and there are no Bash or Linux shell examples provided.
Recommendations
- Present Azure CLI (cross-platform) examples before PowerShell examples, or at least in parallel, to avoid implying Windows is the primary platform.
- Include Linux/Bash shell scripting examples for filtering and formatting output, such as using jq or grep with az CLI output.
- Use platform-neutral file paths (e.g., ./sku-list.json) in CLI examples.
- Explicitly mention that Azure CLI works on Linux, macOS, and Windows, and provide troubleshooting tips for common Linux environments.
- Where PowerShell scripts are provided, offer equivalent Bash scripts for Linux users.
- Add notes or tabs for Linux-specific guidance where relevant, especially for scripting and automation.
Create Pull Request