Document Details
Troubleshoot Nat
❌
This page contains Windows bias
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 moderate Windows bias. In troubleshooting steps, PowerShell commands and Windows-specific tools (like PsPing and Invoke-WebRequest) are highlighted, while Linux equivalents are either less detailed or omitted. In sections on resolving failed states, only PowerShell and Azure Resource Explorer (browser-based, with a browser recommendation) are provided, with no CLI or Linux-native alternatives. In the connectivity validation table, Windows tools are linked and described in more detail than their Linux counterparts. Windows approaches are often listed before Linux ones.
Recommendations:
- Provide equivalent Linux CLI (e.g., Azure CLI, Bash) commands alongside PowerShell examples for managing network interfaces and troubleshooting failed states.
- Expand Linux tool recommendations in the connectivity validation table, e.g., suggest 'curl' or 'wget' for TCP tests, and 'socat' or 'iperf' for UDP tests, with example commands.
- Avoid recommending only Windows-specific tools (like PsPing) without mentioning cross-platform or Linux alternatives.
- Where PowerShell is used, add Azure CLI or REST API examples for parity.
- Ensure Linux and Windows instructions are presented with equal detail and prominence, and avoid consistently listing Windows approaches first.
Create pull request