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:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows bias by providing command-line examples (such as nslookup) in a Windows context (e.g., 'c:\ >nslookup ...'), referencing PowerShell-specific tools (Test-NetConnection), and using Windows terminology (editing the 'hosts file' on the 'on-premises appliance') without offering equivalent Linux or cross-platform instructions. There are no explicit Linux/Bash examples or mentions of Linux tools for network troubleshooting, and the default context for command-line operations is Windows.
Recommendations:
- Provide Linux/Bash equivalents for all command-line examples (e.g., show both 'nslookup' and 'dig' commands, and show Linux shell prompts like '$').
- Include instructions for editing the hosts file on Linux systems (e.g., '/etc/hosts') alongside Windows instructions.
- For PowerShell-specific tools like 'Test-NetConnection', offer cross-platform alternatives such as 'telnet', 'nc' (netcat), or 'curl' for port testing on Linux.
- Use neutral or cross-platform language when referring to the command line or appliance OS (e.g., 'on the command line' instead of 'on the on-premises appliance').
- Add screenshots or terminal outputs from Linux environments where appropriate.
- Explicitly state that the troubleshooting steps apply to both Windows and Linux appliances, and call out any OS-specific differences.
Create pull request