Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits a Windows bias by prioritizing PowerShell-based troubleshooting steps and examples, referencing Windows-specific error codes (e.g., WinError), and focusing on Azure PowerShell modules and commands. Linux equivalents (such as bash or shell commands) are either missing or mentioned only in error messages, with no corresponding troubleshooting steps or examples. The guidance assumes the use of PowerShell and Windows tools, with little attention to Linux-native workflows or commands.
Recommendations
- Provide Linux-specific troubleshooting steps and examples alongside PowerShell instructions, such as using bash or shell commands for module installation and updates.
- Include guidance for managing PATH and SSH client binaries on Linux systems, with explicit examples for common distributions.
- Offer parity in error resolution steps for both Windows and Linux, including installation and permission troubleshooting using Linux-native tools (e.g., apt, yum, chmod).
- Reference Linux package managers and environment variables where appropriate, not just PowerShell Gallery and Windows PATH.
- Ensure that CLI examples are not limited to Azure CLI and PowerShell, but also include relevant Linux shell commands where applicable.
Create Pull Request