Sad Tux - Windows bias detected
This page contains Windows bias

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

Bias Analysis

Detected Bias Types
windows_first
missing_linux_example
powershell_heavy
windows_tools
Summary
The documentation demonstrates a strong Windows bias. All virtual machine creation examples use Windows Server images (win2019datacenter), and the only provided instructions for configuring backend servers use PowerShell commands to install IIS (a Windows web server) via the CustomScriptExtension. There are no Linux VM examples, nor are there instructions for installing or configuring a web server on Linux. Additionally, the test instructions reference Internet Explorer, a Windows-only browser, and do not mention Linux alternatives.
Recommendations
  • Provide parallel examples for Linux virtual machines, such as using Ubuntu or CentOS images in the az vm create commands.
  • Include instructions for installing and configuring a web server (e.g., Apache or Nginx) on Linux VMs using the CustomScriptExtension with bash commands.
  • When referencing tools or browsers for testing (e.g., Internet Explorer), also mention Linux-compatible alternatives such as Firefox or Chromium.
  • Ensure that all scripts and automation steps have both Windows and Linux variants, and clearly label them.
  • Consider alternating the order of Windows and Linux examples or presenting them side-by-side to avoid 'windows_first' bias.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2025-08-17 00:01 #83 cancelled Clean Clean
2025-07-13 21:37 #48 completed Biased Biased
2025-07-12 23:44 #41 cancelled Biased Biased

Flagged Code Snippets

  array=(1 2)
  for n in "${array[@]}"
  do
    az vm create \
    --resource-group CreateIntLBQS-rg \
    --name myVM$n \
    --nics myNicVM$n \
    --image win2019datacenter \
    --admin-username azureuser \
    --availability-set myAvailabilitySet \
    --no-wait
  done
  az vm create \
    --resource-group CreateIntLBQS-rg \
    --name myTestVM \
    --nics myNicTestVM \
    --image Win2019Datacenter \
    --admin-username azureuser \
    --no-wait
  array=(myVM1 myVM2)
    for vm in "${array[@]}"
    do
     az vm extension set \
       --publisher Microsoft.Compute \
       --version 1.8 \
       --name CustomScriptExtension \
       --vm-name $vm \
       --resource-group CreateIntLBQS-rg \
       --settings '{"commandToExecute":"powershell Add-WindowsFeature Web-Server; powershell Add-Content -Path \"C:\\inetpub\\wwwroot\\Default.htm\" -Value $($env:computername)"}'
  done