Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a moderate Windows bias. Windows tools and patterns (such as RDP, PowerShell) are often mentioned before or more prominently than their Linux equivalents. Some examples and instructions are Windows-centric or list Windows tooling first, and there is a lack of parity in Linux-specific examples or guidance, especially for common administrative tasks.
Recommendations
- Ensure that Linux and Windows instructions are presented with equal prominence and in parallel where possible (e.g., 'Connect via RDP (Windows) or SSH (Linux)' should be consistently paired in all relevant sections).
- Provide Linux-specific examples and commands alongside PowerShell, such as Bash/CLI equivalents, especially in sections listing how to retrieve supported images or manage resources.
- When referencing tools (e.g., RDP, PowerShell), always mention the Linux alternatives (e.g., SSH, Bash) at the same time, not as an afterthought.
- Add explicit Linux-focused walkthroughs for tasks like preparing a VM, mounting disks, and verifying pool nodes, not just generic or Windows-first instructions.
- Review all code snippets and ensure that, for every Windows/PowerShell example, a Linux/Bash/CLI equivalent is provided.
- In portal instructions, clarify SSH login steps for Linux as thoroughly as RDP steps for Windows, including any differences in credential setup or troubleshooting.
Create Pull Request