Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits mild Windows bias. Windows tools (PowerShell, RDP) are mentioned before or more prominently than their Linux equivalents (Azure CLI, SSH). Examples and instructions often reference Windows first, and PowerShell is listed as a primary method for discovering supported images. In some places, Linux-specific guidance is present but less emphasized, and there are no explicit Linux shell command examples for key steps (e.g., preparing a VM, mounting disks).
Recommendations
- Provide Linux shell (bash) examples alongside PowerShell for listing supported images and other key operations.
- Mention Azure CLI before or alongside PowerShell when listing tools for image discovery.
- Add explicit Linux instructions for mounting and formatting attached data disks during VM preparation.
- Ensure parity in login instructions (e.g., SSH for Linux is mentioned, but RDP for Windows is described first; consider equal prominence).
- Where purchase plan information is referenced, ensure Linux and Windows guidance is equally detailed and visible.
- Include troubleshooting or common issues for both Windows and Linux pool nodes.
Create Pull Request