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 demonstrates a moderate Windows bias. Windows tools (PowerShell, WinRM, Sysprep) are frequently mentioned, often with detailed examples and troubleshooting steps. PowerShell commands are shown alongside Azure CLI, but Windows-specific patterns (e.g., Sysprep, Windows Update, restart customizers) receive more attention and troubleshooting coverage. Linux equivalents (waagent, SSH, shell scripting) are present but less detailed, and sometimes appear after Windows instructions. Some troubleshooting sections and examples are Windows-centric, with Linux guidance either brief or missing.
Recommendations
- Ensure Linux troubleshooting steps are as detailed as Windows ones, especially for common errors and customizations.
- Provide Linux-first or parallel examples for all CLI and scripting instructions, not just PowerShell.
- Expand Linux-specific error messages and solutions (e.g., waagent failures, SSH connectivity, Linux file permissions) to match the coverage of Windows topics.
- Balance the order of presentation so Linux and Windows instructions appear together or alternate, rather than Windows-first.
- Include more Linux shell script samples and troubleshooting logs, especially for customization and deprovisioning steps.
- Reference Linux-specific documentation and support resources as prominently as Windows ones.
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
|