Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation exhibits a moderate Windows bias. PowerShell examples and terminology are presented first and most frequently, with detailed inline and external script samples using PowerShell. CLI/bash support is mentioned but less emphasized, and Linux/macOS-specific guidance is sparse. Windows tools (e.g., CommandLineToArgvW) and PowerShell-centric troubleshooting are referenced without Linux equivalents. The 'Try it' instructions and management sections prioritize PowerShell, and some sample scripts are PowerShell-only, with CLI/bash examples appearing later or less prominently.
Recommendations
- Provide equal, side-by-side examples for both PowerShell and Azure CLI/bash throughout the documentation, especially in sample templates and inline/external script sections.
- Ensure 'Try it' instructions and management workflows include both PowerShell and Azure CLI commands, with clear guidance for Linux/macOS users.
- Reference Linux/macOS tools and patterns where Windows-specific ones are mentioned (e.g., explain argument parsing for bash, alternatives to CommandLineToArgvW).
- Clarify that Azure CLI/bash scripts can be used on all platforms, and highlight any platform-specific considerations.
- Add troubleshooting and development environment setup instructions for Linux/macOS users, not just PowerShell/Windows.
- When listing supported script types, present Azure CLI/bash first or equally with PowerShell.
Create Pull Request