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.
Create pull request