Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in several ways: troubleshooting steps and scripts are primarily provided in PowerShell, with no Linux shell equivalents; Windows-specific tools and workflows (such as PowerShell cmdlets and Windows VM image preparation) are described in detail, while Linux alternatives are mentioned but not exemplified; and Windows guidance or examples are often presented before Linux ones. There are few, if any, concrete Linux command-line examples for key troubleshooting steps, and Linux-specific troubleshooting is limited to cloud-init and waagent.conf configuration.
Recommendations
- Provide Linux shell (bash) equivalents for all PowerShell troubleshooting commands and scripts, especially for network diagnostics and resource management.
- Include Linux-specific workflows and examples for VM image preparation and troubleshooting, with step-by-step guidance matching the detail given for Windows.
- Ensure that troubleshooting steps for both Windows and Linux VMs are presented in parallel, with equal prominence and depth.
- Add references to Linux-native tools (such as ip, netstat, curl, etc.) where appropriate, alongside Windows tools.
- Where PowerShell is used for Azure Resource Manager or API calls, provide REST API curl examples or Azure CLI equivalents for Linux users.
Create Pull Request