Document Details
Troubleshoot Assessment
❌
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:
⚠️
windows_first
⚠️
windows_tools
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias in several ways: Windows-specific tools and protocols (WinRM, WMI, PowerShell cmdlets) are mentioned explicitly and often before their Linux equivalents. Troubleshooting steps and error codes reference Windows technologies in detail, while Linux guidance is less specific or missing. For example, adding IPs to WinRM TrustedHosts is described, but no equivalent SSH configuration for Linux is provided. Several error codes and fixes focus on Windows (e.g., WMI, application pools, ISAPI filters) with little or no Linux context or examples.
Recommendations:
- Provide equivalent Linux troubleshooting steps and examples wherever Windows-specific instructions are given (e.g., SSH configuration, sudoers, firewall rules).
- When mentioning Windows tools or protocols (WinRM, WMI), also mention the Linux equivalents (SSH, relevant Linux services or commands) and provide parallel instructions.
- Avoid listing Windows steps or tools first by default; alternate or present both Windows and Linux guidance together.
- For error codes and scenarios that are Windows-specific (e.g., WMI, application pools), clarify if there are Linux equivalents or explicitly state that the issue is Windows-only.
- Include Linux-specific error codes, troubleshooting steps, and common issues to ensure parity.
- Where PowerShell or Windows cmdlets are referenced, provide corresponding Bash or Linux command-line examples where applicable.
Create pull request