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 via PowerShell) are provided for interacting with Azure resources. There are no equivalent instructions or examples for Linux or cross-platform environments. Additionally, the order and prominence of Windows tooling and patterns (e.g., Chocolatey installation, PowerShell commands) reinforce this bias, and there is an absence of Linux-native or cross-platform alternatives.
Recommendations:
- Provide equivalent instructions for Linux environments, such as using native package managers (apt, yum) and cross-platform tools (e.g., Azure CLI, curl, jq) instead of Chocolatey and ARMClient.
- Include both Windows and Linux command examples side by side, or clearly indicate which instructions apply to which operating system.
- Mention cross-platform tools (such as Azure CLI or REST API via curl) before or alongside Windows-specific tools.
- Avoid assuming the use of Windows-specific package managers (like Chocolatey) or shells (PowerShell) as the default.
- Explicitly state OS requirements or alternatives where Windows-only tools are referenced.
Create pull request