Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation displays moderate Windows bias. Windows examples and PowerShell commands are presented before Linux equivalents, and some critical steps (such as uploading and creating managed disks from .vhd files) are only shown using Windows/PowerShell tooling, with no Linux CLI or cross-platform alternatives. References to Hyper-V and Windows-centric features appear more frequently and are linked before Linux resources. While Linux support is mentioned and some CLI examples are provided, Linux users may encounter friction due to missing or less prominent Linux-specific guidance.
Recommendations
- Provide equivalent Linux examples for all PowerShell commands, especially for tasks like creating managed disks from .vhd files (e.g., using Azure CLI or REST API).
- Ensure Linux and Windows examples are presented with equal prominence, ideally side-by-side or in parallel sections.
- Include references to Linux-specific documentation and tools where appropriate, not just Windows/Hyper-V.
- When listing supported images or features, alternate the order or group by OS type to avoid Windows-first presentation.
- Add explicit instructions for Linux users in sections where only Windows/PowerShell guidance is given.
Create Pull Request