Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page exhibits a moderate Windows bias. PowerShell is frequently used for examples and scripts, often before or in addition to Azure CLI. Some critical template validation and resource inspection tasks are shown only with PowerShell, with no Linux/macOS equivalents or cross-platform alternatives. There are references to Windows-specific artifacts and scripts (e.g., .ps1 files, Windows VM images) without balancing Linux examples. This may create friction for Linux/macOS users, especially those who do not use PowerShell.
Recommendations
- Provide equivalent Bash/Azure CLI scripts for all PowerShell examples, especially for template validation and resource inspection.
- Ensure that all code samples using Windows-specific artifacts (e.g., .ps1 scripts, Windows VM images) are accompanied by Linux alternatives (e.g., .sh scripts, Linux VM images).
- Where PowerShell modules or cmdlets are referenced, mention cross-platform tools or clarify if PowerShell Core is supported on Linux/macOS.
- Order examples so that cross-platform tools (Azure CLI, Bash) are shown first or alongside PowerShell.
- Add explicit notes or sections for Linux/macOS users, highlighting any differences or additional steps required.
Create Pull Request