Document Details
Image Builder Troubleshoot
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation exhibits moderate Windows bias. Windows tools (PowerShell, Sysprep, WinRM, Windows-specific error codes) are frequently mentioned, often with detailed examples and troubleshooting steps. Linux equivalents (waagent, SSH, shell scripts) are referenced but generally with less detail and sometimes only as secondary notes. Some troubleshooting sections and examples (e.g., Sysprep, Windows Update, restart errors) are Windows-centric, with Linux guidance either missing or less emphasized.
Recommendations
- Ensure Linux troubleshooting examples are provided alongside Windows ones, with equal detail (e.g., show waagent errors, Linux restart issues, Linux-specific log analysis).
- Present Linux and Windows commands in parallel, rather than Windows-first (e.g., show Azure CLI and shell examples before PowerShell).
- Expand Linux-specific error scenarios and solutions, such as permissions, SSH connectivity, and customization failures.
- Reference Linux documentation and support resources as prominently as Windows ones.
- Where Windows tools (PowerShell, Sysprep) are explained in detail, provide similar depth for Linux tools (waagent, shell scripting, systemd, etc.).
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-14 01:31 | #124 | completed |
Biased
|
| 2026-01-13 06:17 | #109 | completed |
Biased
|
| 2026-01-12 00:00 | #101 | completed |
Biased
|
| 2026-01-10 00:00 | #94 | completed |
 Clean
|
| 2026-01-09 19:00 | #91 | completed |
Clean
|
| 2026-01-06 22:28 | #80 | completed |
Clean
|