Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in its testing instructions: it explicitly directs users to open PowerShell on the test VM and provides only PowerShell-based commands (nslookup) for connectivity testing. There are no Linux shell examples or instructions for users who may have deployed a Linux VM, nor is there mention of alternative tools or commands (e.g., dig, curl, wget) commonly used on Linux. The documentation implicitly assumes the test VM is running Windows, and does not provide parity for Linux users.
Recommendations
- Include instructions and examples for testing connectivity from a Linux VM, such as using the Bash shell.
- Provide equivalent Linux commands for DNS resolution (e.g., 'dig webapp-1.azurewebsites.net' or 'host webapp-1.azurewebsites.net') and HTTP requests (e.g., 'curl https://webapp-1.azurewebsites.net').
- Explicitly state that the test VM can be either Windows or Linux, and offer guidance for both environments.
- Avoid assuming PowerShell is the default shell; mention alternatives and provide cross-platform examples side-by-side.
- Where screenshots or output are shown, include Linux equivalents to ensure parity.
Create Pull Request