Detected Bias Types
Powershell Heavy
Windows First
🔧
Windows Tools
Summary
The documentation covers both Linux and Windows VM image creation with Azure Image Builder, but there is a notable Windows bias in several areas. PowerShell examples and references are frequently given, sometimes before or instead of Linux equivalents. Windows-specific tools (e.g., Get-FileHash, Sysprep) are mentioned with detailed instructions, while Linux tools (e.g., sha256sum, waagent) are referenced but less emphasized. Some customizers (WindowsRestart, WindowsUpdate, PowerShell) are Windows-only, and this is clearly documented. However, in sections like checksum generation, Windows/PowerShell instructions are often more prominent or detailed than Linux equivalents.
Recommendations
- Ensure Linux (bash/terminal) examples are provided alongside PowerShell examples, especially for checksum generation and image build operations.
- Present Linux and Windows examples in parallel or alternate order, rather than defaulting to Windows/PowerShell first.
- Expand Linux tool instructions (e.g., explain how to use sha256sum, wget, curl) with the same detail as Windows tools.
- Where possible, clarify when a feature or customizer is Windows-only, and offer Linux alternatives or workarounds if available.
- Add explicit bash/terminal commands for common operations (e.g., starting/cancelling builds, querying resources) alongside Azure CLI/PowerShell.
- Review the order and prominence of Windows vs. Linux content to ensure parity.