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 generally uses cross-platform (bash) examples for environment variable setting and AzCopy usage, which is good for Linux parity. However, there are several areas of Windows bias: (1) PowerShell is used exclusively for secure variable entry (e.g., prompting for secrets), with no Linux shell equivalent shown; (2) Windows tools and patterns are referenced, such as exporting certificates from the Windows certificate store and referencing the Export-PfxCertificate PowerShell cmdlet, with no Linux alternatives or guidance; (3) When discussing certificate handling, the documentation assumes a Windows-centric workflow (certificate store, PFX export), and Linux users are not given parallel instructions. These biases may make the documentation less approachable for Linux users.
Recommendations
  • For every PowerShell example (such as using Read-Host to securely prompt for secrets), provide an equivalent Linux shell example (e.g., using 'read -s' in bash).
  • When referencing Windows certificate store and Export-PfxCertificate, also provide instructions for exporting certificates on Linux (e.g., using openssl to convert/export certificates).
  • Explicitly mention Linux and macOS workflows wherever Windows-specific tools or patterns are discussed, ensuring parity in guidance.
  • Where screenshots or UI instructions are given (such as Azure portal steps), clarify that these are OS-agnostic or provide notes if any steps differ by OS.
  • Consider adding a short section or callout at the top clarifying that all AzCopy commands are cross-platform, and note any OS-specific caveats.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2025-08-19 00:01 #85 completed Clean Clean
2025-07-13 21:37 #48 completed Biased Biased
2025-07-12 23:44 #41 cancelled Biased Biased

Flagged Code Snippets

$env:AZCOPY_SPA_CLIENT_SECRET="$(Read-Host -prompt "Enter key")"
$env:AZCOPY_SPA_CERT_PASSWORD="$(Read-Host -prompt "Enter key")"
$Env:AZCOPY_AUTO_LOGIN_TYPE="PSCRED"