Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
Summary
The documentation page consistently recommends Azure Cloud Shell as the primary troubleshooting environment and provides all command-line examples using Bash. While Bash is cross-platform, the documentation does not mention or provide guidance for running commands on native Linux or macOS terminals, nor does it address differences in local environments versus Cloud Shell. There are no references to Windows-specific tools (e.g., PowerShell), but the documentation assumes the use of Azure Cloud Shell, which is more commonly used by Windows users and may not be the default for Linux administrators. There is a lack of explicit Linux parity, as the instructions do not discuss how to perform troubleshooting steps outside of Cloud Shell or on Linux systems.
Recommendations
- Add explicit instructions for running troubleshooting commands on native Linux and macOS terminals, including any prerequisites (such as installing kubectl, Azure CLI, etc.).
- Clarify that Bash commands provided can be run on any Bash-compatible shell, not just Azure Cloud Shell.
- Include a section comparing troubleshooting in Azure Cloud Shell versus local Linux/macOS environments, highlighting any differences or additional steps required.
- If relevant, mention how to perform troubleshooting using PowerShell for Windows users to ensure parity for all platforms.
- Avoid language that implies Azure Cloud Shell is the only or preferred method, and instead present it as one of several options.
Create Pull Request