Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page for troubleshooting SSH access to Azure Arc-enabled servers demonstrates a notable Windows/PowerShell bias. Many troubleshooting steps and examples reference Azure PowerShell modules (Az.Ssh, Az.Ssh.ArcProxy) and provide PowerShell commands exclusively, with no equivalent instructions for Linux/macOS users. In sections where both Azure CLI and PowerShell could be used, PowerShell is often mentioned first or exclusively. There is a lack of explicit Linux/macOS guidance for installing required modules or resolving common issues, and some error messages are Windows-specific.
Recommendations
- Provide Linux/macOS-specific troubleshooting steps, including installation and usage of Azure CLI for SSH access.
- Include bash or shell command examples alongside PowerShell commands, especially for module installation and updates.
- Clarify which steps are platform-agnostic and which are Windows-specific, and offer alternatives for non-Windows environments.
- Add guidance for resolving PATH and permissions issues on Linux/macOS, not just referencing PowerShell.
- Ensure error messages and solutions cover both Windows and Linux/macOS scenarios equally.
Create Pull Request