Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation consistently provides Azure PowerShell examples alongside Azure CLI and portal instructions. PowerShell is a Windows-centric tool, and its examples are always shown first in every code tab, before CLI and portal. There is frequent mention of PowerShell-specific switches and behaviors, and the documentation refers to 'Azure PowerShell' and its installation requirements, but does not mention Linux/macOS shell environments or provide any Bash/zsh-specific guidance. The CLI examples are cross-platform, but the ordering and emphasis on PowerShell creates a subtle Windows bias.
Recommendations
- Present Azure CLI examples before PowerShell, as CLI is cross-platform and preferred by many Linux/macOS users.
- Explicitly mention that Azure CLI works on Linux/macOS and provide links or notes about installation on those platforms.
- Add brief notes or tips for Linux/macOS users (e.g., shell quoting differences, file paths, use of backslash vs. forward slash).
- Avoid referring to PowerShell as the default or primary method; treat CLI and PowerShell equally.
- Where possible, clarify that all examples (except PowerShell) are valid for Linux/macOS and Windows.
- Consider adding a short section about platform compatibility for both CLI and PowerShell.
Create Pull Request