Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation covers both Windows and Linux usage for Azure Image Builder, but there is a notable Windows bias in several areas. Windows/PowerShell examples and tools are often presented first, and PowerShell is frequently referenced for tasks like generating SHA256 checksums and running commands. Windows-specific customizers (PowerShell, WindowsRestart, WindowsUpdate) are described in detail, while Linux equivalents are less prominent or missing (e.g., no Linux restart customizer). Windows tools (PowerShell cmdlets) are mentioned for checksum generation, with Linux alternatives referenced but less emphasized. However, Linux support is present throughout, and Linux-specific instructions are included, especially for shell customizers and validations.
Recommendations
- Present Linux and Windows examples side-by-side or alternate which is shown first.
- For checksum generation, mention Linux/Mac commands (sha256sum) before or alongside PowerShell Get-FileHash.
- Clarify limitations (e.g., no Linux restart customizer) and suggest Linux workarounds (such as using shell scripts with 'reboot' and validation logic).
- Expand Linux-specific guidance for common tasks (e.g., file downloads, validation, customization) to match Windows detail.
- Ensure all CLI instructions are equally applicable to Linux/macOS users and highlight cross-platform compatibility.
- Add links to Linux troubleshooting and scripting resources where Windows links are provided.
Create Pull Request