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
powershell_heavy
windows_tools
windows_first
Summary
The documentation exhibits some Windows bias, particularly in the use of PowerShell for prerequisite steps (service principal creation), the mention of Windows-specific tools (PuTTY) as the primary SSH client example, and the ordering of Windows connection instructions before Linux. Linux alternatives are present but often secondary or less detailed.
Recommendations
  • Provide Azure CLI and/or Bash equivalents for all PowerShell commands, especially for service principal and key creation steps.
  • When referencing SSH clients, mention native OpenSSH (available by default on most Linux/macOS systems) before or alongside PuTTY, and clarify that PuTTY is primarily needed on Windows.
  • In connection instructions, present Linux and Windows methods in parallel or in a neutral order, rather than listing Windows first.
  • Ensure that all steps and examples are provided for both Windows and Linux users, with equal detail and prominence.
  • Where possible, link to both Windows and Linux documentation for further actions (e.g., connecting, key creation) rather than only one.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2025-07-12 23:44 #41 cancelled Biased Biased
2025-07-12 00:58 #8 cancelled Clean Clean
2025-07-10 05:06 #7 processing Clean Clean

Flagged Code Snippets

    Connect-Graph -Tenant "your tenant ID" Application.ReadWrite.All
    New-MgServicePrincipal -AppId bf7b6499-ff71-4aa2-97a4-f372087be7f0 -DisplayName "Confidential VM Orchestrator"