Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates several forms of Windows bias. Windows and Windows-specific tools (PowerShell, RDP) are mentioned before or more prominently than their Linux equivalents. Examples and instructions often reference Windows first, and PowerShell is listed as a primary method for discovering supported images, with Linux alternatives (Azure CLI) mentioned second. The portal workflow emphasizes RDP for Windows and only briefly mentions SSH for Linux. There are missing Linux-specific examples for some steps, such as mounting and formatting disks, and the documentation does not provide parity in command-line or scripting examples for Linux users.
Recommendations
- Ensure that Linux-specific instructions and examples (e.g., mounting disks, SSH usage, CLI commands) are presented alongside or before Windows equivalents.
- Provide Bash shell and Linux CLI examples wherever PowerShell is used, and avoid listing PowerShell first unless there is a technical reason.
- Expand portal instructions to equally detail SSH connection steps for Linux, including troubleshooting and verification.
- Include explicit Linux-focused guidance for preparing VMs, such as commands for formatting and mounting disks, and avoiding Windows-centric terminology.
- Review all SDK code samples to ensure they are OS-agnostic or provide both Windows and Linux variants where OS-specific steps are required.
Create Pull Request