Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides examples for Azure PowerShell, Azure CLI, REST API, and Azure Portal. However, PowerShell examples are consistently presented before CLI examples, and PowerShell is referenced heavily throughout, including in important notes and breaking change announcements. There is no explicit mention of Linux/macOS-specific considerations, nor are there any bash or shell script examples. The CLI examples use generic syntax, but PowerShell is given prominence, which may create friction for Linux/macOS users who do not use PowerShell.
Recommendations
- Present Azure CLI examples before PowerShell examples, or alternate the order to avoid Windows-first bias.
- Add explicit bash/shell script examples for common tasks, especially for enabling and updating policies.
- Include notes clarifying that Azure CLI works natively on Linux/macOS and provide links to CLI installation guides for those platforms.
- Reduce the emphasis on PowerShell in notes and breaking change announcements, or provide equivalent CLI-focused notes.
- Where PowerShell is referenced, clarify that it is available cross-platform, or provide alternative commands for bash users.
Create Pull Request