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
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a moderate Windows bias. Windows examples and PowerShell commands are consistently presented before Linux equivalents. Windows-specific tools (PowerShell, WindowsAzureGuestAgent, New-NetFirewallRule) are described in detail, while Linux instructions sometimes refer users to external documentation or provide less guidance. The VM creation links for Linux are inconsistent, and some Linux steps (e.g., firewall configuration) require users to consult their own distribution's documentation, whereas Windows steps are fully detailed.
Recommendations
  • Present Linux and Windows examples side-by-side or alternate which comes first.
  • Provide direct, detailed Linux command examples for all major distributions (Ubuntu, Red Hat, SUSE) rather than referring users to external documentation.
  • Ensure VM creation links for Linux point to the correct template (the Ubuntu link currently points to the Windows template).
  • Offer parity in troubleshooting and error messages for both platforms.
  • Include more context and explanation for Linux-specific steps, matching the detail given to Windows instructions.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-14 00:00 #251 completed Clean Clean
2026-01-13 00:00 #247 completed Biased Biased
2026-01-11 00:00 #241 completed Biased Biased
2026-01-10 00:00 #238 completed Biased Biased
2026-01-09 00:34 #235 completed Biased Biased
2026-01-08 00:53 #232 completed Biased Biased

Flagged Code Snippets