Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides parallel examples for Azure portal, Azure CLI, and Azure PowerShell throughout, but PowerShell (a Windows-centric tool) is given equal prominence as CLI, and is presented in dedicated tabs and code blocks. There is no explicit mention of Linux/macOS alternatives to PowerShell, nor any guidance for users who may not have PowerShell available. In some sections, PowerShell is referenced for tasks that could be completed with cross-platform tools, and the presence of 'ms.custom: devx-track-azurepowershell' suggests a PowerShell focus. However, Azure CLI examples are present and shown before PowerShell, mitigating the bias somewhat.
Recommendations
- Explicitly state that Azure CLI is cross-platform and preferred for Linux/macOS users.
- Add notes clarifying that PowerShell examples are primarily for Windows users, and suggest Bash or shell scripting alternatives for Linux/macOS.
- Where PowerShell is used for role assignments or resource queries, provide equivalent Bash/CLI commands.
- Review and minimize references to Windows-specific tools unless necessary; ensure parity in example depth and clarity for CLI and PowerShell.
- Consider adding a section or FAQ for Linux/macOS users outlining recommended tools and installation steps.
Create Pull Request