Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
powershell_heavy
windows_tools
Summary
The documentation page exhibits Windows bias in several ways: all virtual machine creation examples use Windows Server images, and all configuration and testing steps assume Windows-based tools (e.g., RDP, PowerShell, IIS). The only scripting example provided for VM configuration uses Azure PowerShell and installs IIS via Windows PowerShell commands. There are no examples or instructions for deploying or configuring Linux VMs, using SSH, or installing equivalent Linux web servers (e.g., Apache or Nginx). The documentation does not mention Linux tools or patterns, and Windows-centric terminology and procedures are used throughout.
Recommendations
- Add parallel instructions and screenshots for deploying Linux-based VMs (e.g., Ubuntu) in both the spoke and on-premises networks.
- Provide examples for installing a web server on Linux VMs (e.g., using apt to install Apache or Nginx) and testing connectivity via SSH.
- Include sample Azure CLI commands for Linux users, in addition to PowerShell examples.
- Mention SSH as an alternative to RDP for remote access, and show how to configure firewall rules for SSH (port 22).
- Ensure that all steps referencing VM creation, configuration, and testing include both Windows and Linux options, with equal prominence.
Create Pull Request