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
missing_linux_example
Summary
The documentation exhibits a Windows-first bias, most notably in the cluster creation workflow where Windows is the default OS and the only example for certificate creation is provided via a PowerShell script (.ps1) with instructions to run it in PowerShell. There are no equivalent Linux/bash examples or guidance for Linux users, despite the product supporting both Windows and Linux clusters.
Recommendations
  • Provide explicit Linux examples alongside Windows, especially for certificate creation (e.g., using OpenSSL commands in bash).
  • When describing OS selection, avoid defaulting to Windows or clarify that both Windows and Linux are supported equally.
  • Include instructions for Linux users on how to generate the required certificate and fill in the necessary fields.
  • Ensure that screenshots and step-by-step instructions are not exclusively Windows-centric.
  • Where scripts are referenced (such as Create-ClusterCertificate.ps1), provide or link to equivalent bash scripts or OpenSSL command lines for Linux environments.
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-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 Clean Clean
2025-07-09 13:09 #3 cancelled Clean Clean
2025-07-08 04:23 #2 cancelled Biased Biased