Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page exhibits a Windows bias by prioritizing PowerShell-based troubleshooting steps and examples, referencing Windows-specific error messages and tools, and omitting equivalent Linux command-line instructions or examples. Most troubleshooting guidance is centered around Azure PowerShell modules and commands, with little to no mention of Linux-native workflows or commands. Error messages and solutions often assume a Windows environment, and Linux alternatives are either missing or mentioned only in passing.
Recommendations
- Provide Linux-specific troubleshooting steps and examples alongside PowerShell instructions, such as using Bash, SSH, and native Linux tools.
- Include Linux error messages and their resolutions, especially for issues like missing binaries, permissions, and module installation.
- Offer parity in command-line examples by showing both PowerShell and Bash/Azure CLI equivalents for all steps.
- Reference Linux package managers (e.g., apt, yum) for installing required modules or binaries.
- Ensure that environment variable instructions cover both Windows (PATH) and Linux ($PATH) conventions.
- Add troubleshooting guidance for common Linux SSH issues, such as SELinux/AppArmor restrictions, file permissions, and service management (systemctl).
Create Pull Request