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 exhibits a Windows bias by specifying a Windows PC and Windows Administrator account as prerequisites, listing PowerShell as a required tool, and referencing Windows-specific technologies (e.g., WinRM, Windows Server Failover Clustering). There are no Linux equivalents or alternatives mentioned for these requirements, and no Linux-specific instructions or examples are provided. The documentation assumes a Windows environment throughout, even though Azure CLI and kubectl are cross-platform tools.
Recommendations
  • Update the prerequisites to include support for Linux and macOS platforms, clarifying that Azure CLI and kubectl are cross-platform.
  • Provide Linux (and optionally macOS) equivalents for all steps, including installation instructions for required tools (Azure CLI, kubectl, PowerShell) on those platforms.
  • Where PowerShell is required, clarify if PowerShell Core (pwsh) is supported on Linux/macOS, and provide usage examples.
  • For steps referencing Windows-specific technologies (e.g., WinRM, Windows Server Failover Clustering), explain if/how these steps can be performed from Linux/macOS, or provide alternative approaches.
  • Avoid language that assumes the user is on Windows (e.g., 'A Windows PC with internet access'), and instead use inclusive phrasing such as 'A computer with internet access (Windows, Linux, or macOS)'.
  • Add explicit notes or callouts wherever a step is only supported or tested on Windows, and provide a roadmap or workaround for users on other platforms.
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