Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
powershell_heavy
Summary
The documentation covers both Windows and Linux VMs, but there are signs of Windows bias. PowerShell examples are provided alongside Azure CLI, but there are no explicit Bash or Linux shell script examples. The ARM template example is Windows-centric, with only Windows Server images and parameters. In some sections, Windows-specific terminology (e.g., password complexity, RDP port 3389) appears before Linux equivalents, and PowerShell is given equal prominence despite being Windows-focused. Linux users may need to adapt some steps or infer details for their environment.
Recommendations
- Add explicit Linux-focused examples in ARM templates (e.g., Ubuntu or CentOS images, SSH key authentication instead of password).
- Include Bash shell script examples for common operations, especially for associating VMs to capacity reservation groups.
- Clarify password/SSH authentication requirements for Linux VMs in portal and template instructions.
- Balance the order of CLI and PowerShell examples, or note that PowerShell is primarily for Windows users.
- In ARM templates, provide both Windows and Linux image references and OS configuration options.
Create Pull Request