Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides examples for HTTP, Azure CLI, and Azure PowerShell, with PowerShell (Windows) examples given equal prominence to CLI and HTTP. There is a slight Windows-first bias in the ordering and explicit mention of PowerShell, while Linux-specific tools (such as Bash scripts or shell commands) are not shown in the main example tabs. Additionally, some features and improvements are described with Windows-specific terminology (e.g., PowerShell, Windows Update, Windows restart) before or alongside Linux equivalents, but Linux features are generally present. There are no outright missing Linux examples, but the documentation could do more to highlight Linux parity and provide Linux-first or Linux-specific usage patterns.
Recommendations
- Add explicit Bash or shell script examples alongside PowerShell in code tabs, especially for Linux users.
- When listing features or improvements, alternate or balance the order between Windows and Linux terminology, or group them by OS for clarity.
- Provide Linux-specific troubleshooting examples and error messages where relevant.
- Ensure that Linux tools and patterns (e.g., cloud-init, shell scripting) are mentioned with equal prominence as Windows tools.
- Consider adding a section or callout for Linux users summarizing best practices and common patterns for VM Image Builder on Linux.
Create Pull Request