Bias Analysis
Detected Bias Types
windows_first
windows_tools
powershell_heavy
missing_linux_example
Summary
The documentation exhibits several signs of Windows bias. VM creation examples consistently use Windows images (e.g., 'Win2016Datacenter') in both Azure CLI and PowerShell scripts, with no Linux equivalents shown. The variable names and authentication methods (password-based, not SSH keys) are tailored to Windows scenarios. PowerShell is given equal prominence to Azure CLI, despite being Windows-centric. There are no explicit Linux VM creation examples, nor are there instructions or code samples for Linux-specific deployment patterns (e.g., using SSH keys, specifying a Linux image, or Linux admin username conventions).
Recommendations
- Add Linux VM creation examples alongside Windows ones in all CLI and PowerShell sections (e.g., use Ubuntu or CentOS images, SSH authentication).
- Show how to specify SSH keys for Linux VMs in CLI and PowerShell scripts.
- Include Linux-specific variable naming and admin username conventions.
- Explicitly mention that Azure CLI works cross-platform and provide Linux/macOS installation guidance.
- Where PowerShell is referenced, clarify its availability on Linux/macOS, or suggest Bash alternatives.
- In portal instructions, show screenshots or steps for Linux VM creation and disk attachment.
Create Pull Request