Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all operations, but PowerShell (a Windows-centric tool) is given equal prominence throughout. There is no mention of Linux-specific shell patterns (e.g., bash, zsh), nor are there any explicit Linux terminal instructions or notes about cross-platform differences. PowerShell is traditionally a Windows-first tool, and its inclusion alongside CLI may suggest a bias toward Windows users. Additionally, file path examples use Windows-style backslashes in PowerShell commands, reinforcing the Windows context.
Recommendations
- Add explicit notes clarifying that Azure CLI commands work natively on Linux/macOS and Windows.
- Include bash/zsh shell examples or clarify that CLI commands are intended for bash-style shells on Linux/macOS.
- Mention installation and usage of Azure CLI on Linux/macOS, including package manager instructions (e.g., apt, yum, brew).
- For PowerShell, clarify cross-platform availability and provide guidance for Linux/macOS users if relevant.
- Use platform-neutral file paths in examples, or provide both Windows and Linux/macOS path formats where applicable.
- Consider ordering examples with Azure CLI (cross-platform) first, and PowerShell second, to reduce Windows-first perception.
Create Pull Request