Bias Analysis
Detected Bias Types
windows_first
windows_tools
missing_linux_example
Summary
The documentation provides parity for both Windows and Linux virtual machines in terms of supported features and CLI/API usage. However, there is a notable Windows bias in the ARM template section, which only demonstrates Windows VM image deployment and omits any Linux image example or parameter. Additionally, the PowerShell examples (a Windows-centric tool) are given equal prominence as CLI, but CLI examples do use Linux images. The order of examples sometimes places PowerShell before ARM template, and the ARM template itself is Windows-only, which may create friction for Linux users seeking infrastructure-as-code guidance.
Recommendations
- Add a Linux VM ARM template example or include parameters for both Windows and Linux images in the ARM template section.
- Clarify in the ARM template section that the example is for Windows and provide a link or guidance for Linux VM ARM template usage.
- Consider alternating the order of CLI and PowerShell examples, or explicitly state that both are supported on Windows, macOS, and Linux (where applicable).
- Ensure that infrastructure-as-code examples (ARM templates, Bicep, Terraform) demonstrate both Windows and Linux VM scenarios.
Create Pull Request