Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates Windows bias in several ways. The only command-line example for querying private DNS zones uses Chocolatey and ARMClient, both Windows-centric tools, with instructions and commands given in PowerShell syntax. There are no equivalent Linux or cross-platform instructions or examples. The troubleshooting section mentions 'Test-NetConnection', a Windows PowerShell cmdlet, before mentioning 'nslookup', which is cross-platform. There is no mention of Linux-native package managers or CLI tools, nor are Linux shell commands provided. This may hinder Linux users or those working in cross-platform environments.
Recommendations
- Provide Linux and macOS equivalents for command-line instructions, such as using curl, wget, or Azure CLI instead of ARMClient and Chocolatey.
- Include installation instructions for ARMClient or Azure CLI via Linux package managers (apt, yum, Homebrew).
- Show both PowerShell and Bash examples for all command-line steps.
- Mention cross-platform tools first (e.g., Azure CLI) before Windows-specific tools.
- In troubleshooting, list cross-platform commands (e.g., nslookup, dig, curl) before Windows-only commands like Test-NetConnection.
- Explicitly state which steps are platform-specific and provide alternatives for other platforms.
Create Pull Request