Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides both Windows and Linux examples for Azure Image Builder, but there is a notable Windows bias in several areas. PowerShell is frequently referenced for checksum generation and image operations, often before Linux equivalents. Windows-specific customizers (PowerShell, WindowsRestart, WindowsUpdate) are described in detail, while Linux customizers (Shell) are covered but less prominently. Windows tools and commands (e.g., PowerShell cmdlets, Sysprep) are mentioned first or exclusively in some sections, and instructions for generating checksums or performing operations often default to Windows/PowerShell before Linux alternatives.
Recommendations
- Ensure Linux (bash/terminal) examples are provided alongside PowerShell examples for all operations, especially checksum generation and image template operations.
- Present Linux and Windows examples with equal prominence, alternating which is shown first or grouping by OS.
- Add more detailed Linux-specific guidance for customizers and validations, matching the depth given to Windows customizers.
- Where possible, reference cross-platform tools (e.g., Azure CLI) before platform-specific tools (e.g., PowerShell).
- Clarify in each section which features are Windows-only and which are cross-platform to avoid confusion.
Create Pull Request