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
missing_linux_example
windows_first
Summary
The documentation demonstrates a Windows bias by providing only PowerShell-based instructions for interacting with Azure resources (e.g., opening PowerShell, using ARMClient in a PowerShell window), and does not mention or provide equivalent steps for Linux or macOS users. The ARMClient tool is introduced with a Windows-centric installation process (downloading and unzipping a .zip, running in PowerShell), and there are no Bash or cross-platform CLI alternatives shown. This may hinder users on non-Windows platforms from following the troubleshooting steps effectively.
Recommendations
  • Provide equivalent Linux/macOS instructions, such as using Bash or Azure CLI commands for authentication and resource queries.
  • Mention and demonstrate how to install and use ARMClient (or an equivalent tool) on Linux/macOS, or suggest cross-platform alternatives (e.g., Azure CLI az rest).
  • When listing steps, avoid assuming the user is on Windows; present cross-platform options or indicate which steps are OS-specific.
  • If PowerShell is required, clarify if PowerShell Core (pwsh) can be used on Linux/macOS, and provide relevant instructions.
  • Consider reordering or parallelizing instructions so that Linux/macOS methods are presented alongside Windows methods, rather than after or not at all.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2025-08-17 00:01 #83 cancelled Clean Clean
2025-07-13 21:37 #48 completed Clean Clean
2025-07-12 23:44 #41 cancelled Biased Biased
2025-07-09 13:09 #3 cancelled Clean Clean
2025-07-08 04:23 #2 cancelled Biased Biased

Flagged Code Snippets