Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation is heavily focused on PowerShell scripting and Windows-specific patterns. All code samples are written in PowerShell, and instructions reference Windows command prompts and PowerShell-specific commands (e.g., Write-Host, Start-Sleep, ConvertFrom-Json). Prerequisite links and checks are Windows-centric, and there are no Bash, shell, or Linux/macOS scripting equivalents provided. This creates friction for Linux/macOS users, who must adapt the logic to their own shell environments.
Recommendations
- Provide equivalent Bash/shell script examples for Linux/macOS users, using standard shell scripting and jq for JSON parsing.
- Add instructions for checking prerequisites (Azure CLI, authentication) on Linux/macOS, including links to non-Windows installation guides.
- Clarify that Azure CLI commands are cross-platform and show how to use them in Bash or zsh.
- Avoid using PowerShell-specific constructs (e.g., Write-Host, try/catch, Start-Sleep) in generic CLI automation guides, or provide alternatives.
- Include a section or toggle for Linux/macOS users, showing how to perform each step in their environment.
Create Pull Request