Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
powershell_heavy
windows_tools
Summary
The documentation page exhibits a Windows bias in several ways: all virtual machine creation examples use Windows Server images, and installation/configuration steps (such as IIS setup) are provided only for Windows using PowerShell. There are no equivalent Linux VM examples, nor instructions for deploying or configuring Linux workloads (e.g., Apache on Ubuntu). The only scripting example uses PowerShell, and Azure Cloud Shell is explicitly set to PowerShell, with no Bash or CLI alternatives. The documentation does not mention Linux tools or patterns, and Windows-centric terminology (RDP, Windows Server) is used throughout.
Recommendations
- Include parallel instructions for deploying a Linux-based workload VM (e.g., Ubuntu Server), including steps for installing a web server such as Apache or Nginx.
- Provide Azure CLI and/or Bash examples alongside PowerShell for VM extension installation and other automation steps.
- Mention SSH as a remote access method for Linux VMs, and provide examples for connecting via SSH.
- When describing firewall rules, include examples for Linux-based protocols and ports (e.g., SSH port 22).
- Use more neutral terminology when referring to remote access (e.g., 'remote desktop or SSH'), and avoid assuming Windows-only scenarios.
- Add notes or links to Linux-specific documentation for users who prefer or require Linux workloads.
Create Pull Request