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

Bias Types:
⚠️ powershell_heavy
⚠️ windows_tools
⚠️ missing_linux_example
⚠️ windows_first
Summary:
The documentation demonstrates a Windows bias, particularly in the 'Use a custom DNS server' section, where only Windows-specific tools (Chocolatey, ARMClient, PowerShell commands) are provided for interacting with Azure resources. There are no equivalent instructions or examples for Linux or cross-platform environments. Additionally, the troubleshooting section mentions 'Test-NetConnection' (a PowerShell cmdlet) alongside 'nslookup', but does not provide Linux-native alternatives or examples, and Windows tools are mentioned first.
Recommendations:
  • Provide equivalent Linux and cross-platform instructions for installing and using ARMClient (e.g., via npm or .NET global tool), and show how to authenticate and run the same API calls from Linux/macOS.
  • Include Linux-native commands (such as curl, wget, or Azure CLI) for querying Azure REST APIs instead of or in addition to PowerShell/ARMClient.
  • In troubleshooting, add Linux equivalents for network testing, such as 'dig', 'host', or 'curl', and mention them alongside or before Windows-specific tools.
  • Avoid referencing Windows package managers (like Chocolatey) as the only installation method; provide installation steps for Linux (apt, yum, snap, etc.) and macOS (brew) where applicable.
  • When listing tools or commands, present cross-platform or Linux-native options first or at least equally, to ensure parity and inclusivity.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-17 00:01 #83 in_progress ❌ Biased
2025-07-13 21:37 #48 completed ❌ Biased
2025-07-12 23:44 #41 in_progress ❌ Biased

Flagged Code Snippets

choco install armclient