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
Although the documentation is focused on Linux VMs, there are several signs of Windows bias: PowerShell examples are provided extensively and often before or alongside Azure CLI examples, even though PowerShell is not the default scripting environment for most Linux users. Windows-specific tools and terminology (e.g., 'ipconfig', 'Write-Host', '.ps1' scripts, 'New-AzStorageBlobSASToken') are referenced without clear Linux alternatives or context. REST and ARM template examples use Windows-style scripts (PowerShell), and some explanations default to Windows patterns. There are missing Linux-specific examples for certain advanced scenarios (e.g., parameter passing, blob SAS token generation, script URI usage).
Recommendations
  • Provide Bash shell script examples in REST and ARM template sections instead of PowerShell (.ps1) scripts.
  • Clarify when a command or tool is Windows-specific and offer Linux equivalents (e.g., use 'ifconfig' or 'ip a' instead of 'ipconfig').
  • Add Linux-native instructions for generating SAS tokens (e.g., using Azure CLI or azcopy) instead of only referencing PowerShell tools.
  • Ensure parameter passing examples show both Windows (argument style) and Linux (environment variable style) clearly.
  • Where PowerShell is used, explain its applicability to Linux (e.g., PowerShell Core) and provide Bash alternatives.
  • Review all sample scripts and outputs to ensure they use Linux conventions (e.g., .sh scripts, echo, id, etc.) and avoid Windows-centric language.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-02-18 00:00 #396 in_progress Biased Biased
2026-02-17 00:00 #392 in_progress Biased Biased
2026-02-16 00:00 #388 in_progress Biased Biased
2026-02-15 00:00 #384 in_progress Biased Biased
2026-02-14 00:00 #380 in_progress Biased Biased
2026-02-13 00:00 #376 in_progress Biased Biased
2026-02-12 00:00 #372 in_progress Biased Biased
2026-02-11 00:00 #368 in_progress Clean Clean
2026-01-07 06:10 #227 cancelled Clean Clean

Flagged Code Snippets