Bias Analysis
Detected Bias Types
windows_tools
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates mild Windows bias. While most troubleshooting steps use Linux/SSH commands (hostname, nslookup, dig, resolv.conf), there are references to Windows tools and patterns, such as PowerShell cmdlets (Get-AzVirtualNetwork), Azure Runbooks, and the option to deploy a Windows VM as a DNS forwarder. The PowerShell/Windows-specific troubleshooting is mentioned without equivalent Linux CLI or Azure CLI examples, and the PowerShell SDK documentation is referenced directly. In some cases, Windows is mentioned before Linux as a VM option. There are no explicit Linux alternatives for the PowerShell/Runbook steps, and the documentation does not provide Azure CLI or REST API equivalents for network troubleshooting.
Recommendations
- Provide equivalent Azure CLI or REST API commands for network troubleshooting and configuration, alongside PowerShell examples.
- When mentioning VM deployment for DNS forwarding, list Linux and Windows options equally, or mention Linux first if the majority of HDInsight clusters are Linux-based.
- For steps involving PowerShell or Azure Runbooks, add Linux shell script or Azure CLI alternatives.
- Reference both Linux and Windows documentation for VM configuration and DNS forwarding, not just PowerShell SDK.
- Ensure that examples and instructions are platform-neutral or provide parallel instructions for both Windows and Linux users.
Create Pull Request