Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation consistently provides Azure PowerShell and Azure CLI examples for all operations, with PowerShell examples always shown first. There is a strong emphasis on PowerShell, which is traditionally a Windows-centric tool, and no explicit mention of Linux/macOS shell environments or examples using Bash, zsh, or other native Linux tools. There are no references to Linux-specific patterns, nor any guidance for Linux/macOS users on installing or using PowerShell cross-platform. The documentation assumes familiarity with PowerShell syntax and conventions, which may create friction for Linux/macOS users.
Recommendations
- Explicitly state that Azure PowerShell is available cross-platform and provide installation links for Linux/macOS.
- Add example command lines using Bash/zsh syntax for Azure CLI, including common shell idioms (e.g., environment variables, piping output to jq).
- Where PowerShell is referenced, clarify that it is not Windows-only and provide brief instructions for Linux/macOS users.
- Consider showing Azure CLI examples first, as CLI is natively cross-platform and more familiar to Linux/macOS users.
- Add a short section or note on platform compatibility for all tools mentioned.
Create Pull Request