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
windows_tools
powershell_heavy
missing_linux_example
Summary
The documentation exhibits a moderate Windows bias. While it claims to apply to both Windows and Linux VMs, several examples and templates (especially the ARM template) are Windows-centric, with Windows images and parameters shown by default. PowerShell is given equal prominence to Azure CLI, but PowerShell is a Windows-first tool. The ARM template only demonstrates Windows VM creation, with no Linux image or configuration example. Password complexity requirements are described in Windows terms. In most sections, Windows tools and patterns (PowerShell, Windows images) are shown before or instead of Linux equivalents.
Recommendations
  • Add explicit Linux VM ARM template examples, including imageReference for popular Linux distributions (e.g., Ubuntu, CentOS).
  • In ARM template parameters, include both Windows and Linux OS options, with clear instructions for each.
  • Clarify password requirements for Linux VMs (e.g., SSH keys) and provide guidance for Linux administrator account setup.
  • In PowerShell sections, note that PowerShell is cross-platform but most users on Linux/macOS will prefer Azure CLI or REST API.
  • Where examples use Windows-centric terminology (e.g., RDP port 3389), add Linux-relevant alternatives (e.g., SSH port 22).
  • Ensure that Linux is represented equally in example code, screenshots, and step-by-step instructions.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-14 01:31 #124 completed Biased Biased
2026-01-14 00:01 #122 completed Biased Biased
2026-01-13 06:17 #109 completed Biased Biased
2026-01-12 00:00 #101 completed Biased Biased
2026-01-10 00:00 #94 completed Clean Clean
2026-01-09 19:00 #91 completed Clean Clean
2026-01-06 22:28 #80 completed Clean Clean

Flagged Code Snippets