Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a strong Windows bias by exclusively providing PowerShell-based automation scripts and examples. All code samples use PowerShell syntax and constructs (e.g., Write-Host, try/catch, functions, variable assignment), which are not natively supported on Linux/macOS shells. Prerequisite checks and installation links reference Windows-specific instructions first, and there are no equivalent Bash or cross-platform shell examples. This creates friction for Linux/macOS users who cannot directly use the provided scripts.
Recommendations
- Provide equivalent Bash shell scripts for all automation tasks, using standard Bash syntax and constructs.
- Include Linux/macOS installation instructions for Azure CLI and PowerShell, or clarify cross-platform support.
- Explicitly state which parts of the script are Windows/PowerShell-only and offer alternatives for other platforms.
- Consider using only Azure CLI commands in examples, as Azure CLI is cross-platform, and avoid PowerShell-specific scripting unless necessary.
Create Pull Request