Bias Analysis
Detected Bias Types
windows_first
windows_tools
powershell_heavy
missing_linux_example
Summary
The documentation exhibits a moderate Windows bias: Windows terminology (RDP, WinRM) is frequently mentioned, sometimes before or alongside Linux equivalents (SSH). Several links and instructions reference Windows-specific documentation or tools first, and Linux-specific instructions/examples are less detailed or appear later. The password reset instructions reference the Azure portal's 'Reset Password' blade, which is more commonly used for Windows VMs. The Azure Bastion section refers to connecting to a Windows VM using SSH or RDP, but does not provide explicit Linux SSH examples. The Serial Console documentation link points to a Windows-focused page. Linux connection methods are mentioned, but not as thoroughly or prominently.
Recommendations
- Provide explicit Linux SSH connection examples and links alongside Windows RDP/WinRM instructions.
- Ensure documentation links for Serial Console and Bastion include both Linux and Windows guides, or point to OS-neutral pages.
- Clarify that the 'Reset Password' blade works for both Linux and Windows, and provide Linux-specific instructions if there are differences.
- Present Linux and Windows options in parallel, rather than listing Windows tools or documentation first.
- Add troubleshooting notes or caveats specific to Linux VMs where relevant (e.g., SSH key management, password reset differences).
Create Pull Request