Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits a moderate Windows bias. Windows tools and patterns (RDP, PowerShell) are mentioned before or more prominently than their Linux equivalents (SSH, Bash). PowerShell is listed first in API references and examples, and Windows-specific instructions (such as RDP connection) are described before Linux (SSH). There is a lack of Linux-specific command-line examples (e.g., Bash scripts), and some steps, such as mounting and formatting disks, do not provide Linux-specific guidance. The documentation does not provide parity in examples or troubleshooting for Linux users.
Recommendations
- Provide Linux/Bash command-line examples alongside or before PowerShell examples, especially in sections referencing supported images and gallery image definitions.
- Explicitly describe Linux-specific steps for tasks such as mounting and formatting disks, and troubleshooting common Linux pool creation issues.
- In portal instructions, give equal detail to SSH connection for Linux nodes as is given for RDP for Windows nodes.
- Where possible, use neutral language (e.g., 'connect via RDP (Windows) or SSH (Linux)') and avoid listing Windows-first unless there is a technical reason.
- Include troubleshooting tips and best practices for Linux pools, such as handling SELinux, systemd, or other Linux-specific configuration issues.
- Ensure that references to tools (PowerShell, Azure CLI) are balanced and that Linux users are not required to use Windows-centric tooling.
Create Pull Request