Bias Analysis
Detected Bias Types
windows_first
windows_tools
powershell_heavy
missing_linux_example
Summary
The documentation provides examples for both Windows and Linux VMs, but there are several areas of Windows bias. PowerShell examples are given equal prominence to Azure CLI, but PowerShell is a Windows-centric tool. The ARM template example is exclusively for Windows Server images, with no Linux image option shown. The portal instructions reference password complexity requirements typical for Windows, and the ARM template parameters and allowed values are all Windows versions. Linux-specific examples (e.g., ARM template for Ubuntu or Red Hat) are missing, and Windows terminology/tools (PowerShell, Windows images) are mentioned before or instead of Linux equivalents.
Recommendations
- Add ARM template examples for Linux VM images (e.g., Ubuntu, CentOS, Red Hat) alongside the Windows template.
- In portal instructions, clarify password requirements for Linux VMs (e.g., SSH key option, username restrictions).
- Ensure CLI and PowerShell examples show both Windows and Linux image creation, or clarify that the example is for a Linux VM when using Ubuntu.
- In ARM template parameters, include allowed values for popular Linux distributions.
- Where PowerShell is used, note that it is primarily for Windows users, and suggest Bash/CLI for Linux/macOS users.
Create Pull Request