Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and PowerShell examples for all major operations, but PowerShell is given equal prominence as CLI, and is the only shell scripting example shown (no Bash, Linux shell, or macOS-specific guidance). PowerShell is a Windows-centric tool, and its inclusion alongside CLI can create a perception of Windows bias, especially as there are no Linux/macOS-specific shell examples or troubleshooting notes. However, the Azure CLI examples are cross-platform and shown first, mitigating the severity.
Recommendations
- Add Bash or shell scripting examples for Linux/macOS users, especially for parsing JSON output or automating tasks.
- Explicitly state that Azure CLI commands work on Windows, Linux, and macOS.
- Include troubleshooting notes for Linux/macOS environments (e.g., authentication, environment setup).
- Clarify that PowerShell examples are optional and primarily for Windows users.
- Consider adding links to platform-specific setup guides for Azure CLI and PowerShell.
Create Pull Request