Bias Analysis
Detected Bias Types
windows_first
windows_tools
powershell_heavy
arm_template_windows_only
Summary
The documentation covers both Windows and Linux VMs, and provides cross-platform guidance via Azure CLI, API, Portal, and PowerShell. However, there are signs of Windows bias: PowerShell examples and references are prominent, and ARM template examples are Windows-only (no Linux image or parameter options). Windows-specific parameters (e.g., OSVersion) are shown first and exclusively in ARM templates. The CLI examples do use Ubuntu images, but the ARM template and PowerShell sections focus on Windows. The ordering of examples sometimes puts Windows tools (PowerShell) before Linux-friendly ones (CLI).
Recommendations
- Add ARM template examples for Linux VMs, including parameters for Linux images and admin SSH keys.
- In ARM template sections, clarify how to adapt the template for Linux VMs (e.g., show both Windows and Linux imageReference blocks).
- Balance PowerShell and CLI coverage: ensure CLI examples are as detailed as PowerShell, and consider showing CLI before PowerShell.
- When referencing admin credentials, provide guidance for both password (Windows) and SSH key (Linux).
- Review ordering of examples to avoid always showing Windows tools first.
- Explicitly state that all steps apply to both Windows and Linux VMs, and highlight any differences.
Create Pull Request