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 is heavily biased toward Windows environments. All examples, instructions, and screenshots assume a Windows client, with exclusive use of Windows PowerShell and Windows-specific tools (e.g., Notepad, hosts file at C:\Windows\System32\Drivers\etc). There is no mention of Linux or macOS clients, nor are there alternative instructions or examples for non-Windows platforms. The prerequisites and workflow steps explicitly require Windows PowerShell 5.1, and certificate management is described only for Windows. This creates significant friction for Linux/macOS users, who are left without guidance.
Recommendations
  • Add explicit support and examples for Linux and macOS clients, including instructions for installing and using PowerShell Core (pwsh) on those platforms.
  • Provide alternative certificate creation, import, and export steps using cross-platform tools (e.g., OpenSSL, certutil, or PowerShell Core commands).
  • Include instructions for editing the hosts file on Linux (/etc/hosts) and macOS, and mention appropriate text editors (e.g., nano, vi).
  • Clarify whether Azure PowerShell modules (Az, AzureRM) can be used on PowerShell Core on Linux/macOS, and provide examples.
  • Add troubleshooting and verification steps using Linux/macOS command-line tools (e.g., ping, nslookup).
  • State any platform limitations or requirements up front, so users can plan accordingly.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-14 00:00 #250 in_progress Biased Biased
2026-01-13 00:00 #246 completed Biased Biased
2026-01-11 00:00 #240 completed Biased Biased
2026-01-10 00:00 #237 completed Biased Biased
2026-01-09 00:34 #234 completed Biased Biased
2026-01-08 00:53 #231 completed Biased Biased
2026-01-06 18:15 #225 cancelled Clean Clean
2025-08-17 00:01 #83 cancelled Clean Clean
2025-07-13 21:37 #48 completed Clean Clean
2025-07-09 13:09 #3 cancelled Clean Clean
2025-07-08 04:23 #2 cancelled Biased Biased

Flagged Code Snippets