Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Azure CLI and PowerShell examples for most scenarios, but the PowerShell sections are heavily Windows-centric, with all example scripts using Windows-specific parameters (e.g., Set-AzVMOperatingSystem -Windows) and password authentication. There are no PowerShell examples for Linux VM creation, nor any mention of Linux-specific PowerShell patterns. Additionally, network security rules in PowerShell examples focus on RDP (port 3389), which is Windows-specific, and password authentication is shown before SSH key authentication. While CLI and REST examples do show Linux VM creation and SSH, PowerShell coverage is notably biased toward Windows. The order of presentation also often places Windows-centric tools and patterns before Linux equivalents.
Recommendations
- Add PowerShell examples for creating Linux VMs, including use of Set-AzVMOperatingSystem -Linux and SSH key authentication.
- In PowerShell networking examples, include rules for SSH (port 22) alongside or before RDP (port 3389).
- Ensure parity in authentication methods: demonstrate both password and SSH key authentication for both Windows and Linux in all tool examples.
- When presenting examples, alternate or randomize the order of Windows and Linux scenarios, or explicitly provide both side-by-side.
- Review and update documentation to avoid implicit prioritization of Windows tools and patterns.
Create Pull Request