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

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 ID Status Bias Status
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-07-13 21:37 #48 completed ❌ Biased
2025-07-12 23:44 #41 in_progress ❌ Biased

Flagged Code Snippets