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 page exhibits a moderate Windows bias. Windows tools and patterns (RDP, PowerShell) are mentioned before or more prominently than their Linux equivalents (SSH, Bash). PowerShell is listed first in API references and examples, and Windows-specific instructions (such as RDP connection) are described before Linux (SSH). There is a lack of Linux-specific command-line examples (e.g., Bash scripts), and some steps, such as mounting and formatting disks, do not provide Linux-specific guidance. The documentation does not provide parity in examples or troubleshooting for Linux users.
Recommendations
  • Provide Linux/Bash command-line examples alongside or before PowerShell examples, especially in sections referencing supported images and gallery image definitions.
  • Explicitly describe Linux-specific steps for tasks such as mounting and formatting disks, and troubleshooting common Linux pool creation issues.
  • In portal instructions, give equal detail to SSH connection for Linux nodes as is given for RDP for Windows nodes.
  • Where possible, use neutral language (e.g., 'connect via RDP (Windows) or SSH (Linux)') and avoid listing Windows-first unless there is a technical reason.
  • Include troubleshooting tips and best practices for Linux pools, such as handling SELinux, systemd, or other Linux-specific configuration issues.
  • Ensure that references to tools (PowerShell, Azure CLI) are balanced and that Linux users are not required to use Windows-centric tooling.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-14 00:00 #250 in_progress Biased Biased
2026-01-13 00:00 #246 completed Biased Biased
2026-01-12 00:00 #243 cancelled Biased Biased
2026-01-11 00:00 #240 completed Biased Biased
2026-01-10 00:00 #237 completed Biased Biased
2026-01-09 00:34 #234 completed Biased Biased
2026-01-08 00:53 #231 completed Biased Biased
2026-01-06 18:15 #225 cancelled Clean Clean
2025-08-17 00:01 #83 cancelled Clean Clean
2025-07-13 21:37 #48 completed Biased Biased
2025-07-09 13:09 #3 cancelled Clean Clean
2025-07-08 04:23 #2 cancelled Biased Biased

Flagged Code Snippets