Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Linux and Windows coverage for Azure Image Builder, including examples for shell and PowerShell customizers, and validation steps. However, there is a notable Windows bias in several areas: PowerShell and Windows-specific tools (e.g., Get-FileHash, Invoke-WebRequest, Sysprep) are referenced more frequently and often before Linux equivalents; PowerShell commands for checksum generation and image operations are shown alongside Azure CLI, but Windows tools are sometimes mentioned first. Some customizers (WindowsRestart, WindowsUpdate) are Windows-only, but this is appropriate given their OS specificity. Linux examples are present but occasionally less detailed or appear after Windows examples.
Recommendations
- Ensure Linux tools and commands (e.g., sha256sum, wget/curl) are mentioned equally and before or alongside Windows tools in relevant sections.
- Where PowerShell is referenced for checksum generation, provide Linux/Mac equivalents (sha256sum) with equal prominence.
- For image build/cancel operations, show Azure CLI examples first or highlight their cross-platform nature.
- In sections where Windows-specific customizers are described, clarify that Linux alternatives (e.g., Shell customizer for reboots) are not available and suggest workarounds if possible.
- Expand Linux example coverage where possible, ensuring parity in detail and visibility.
Create Pull Request