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 examples and instructions. All code samples use PowerShell syntax and constructs (e.g., Write-Host, try/catch, functions, variable assignment), which are native to Windows and not directly usable 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 provided. This limits accessibility for users on Linux or macOS, who would need to translate the logic to Bash or another shell.
Recommendations
- Provide equivalent Bash shell scripts for all automation steps, using standard Bash syntax and constructs (e.g., echo, if/else, functions, error handling).
- Include Linux/macOS installation instructions and links for Azure CLI and PowerShell, not just Windows.
- Clearly indicate which examples are for Windows/PowerShell and which are for Linux/Bash, ideally presenting both side by side.
- Avoid using PowerShell-specific constructs in generic Azure CLI examples; use plain CLI commands where possible.
- Add a section explaining cross-platform compatibility and how users can adapt scripts for their OS.
Create Pull Request