Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a moderate Windows bias: PowerShell examples and references are given equal or greater prominence than Azure CLI, with some links and examples (e.g., finding images in the Azure Marketplace, sharing images) referencing Windows-specific pages or PowerShell first. Windows tools and terminology (Sysprep, Hyper-V generation) are mentioned before or more thoroughly than their Linux equivalents. Linux-specific instructions (e.g., waagent for generalization, Linux upload VHD) are present but often referenced after Windows or in less detail. Some example links and troubleshooting guides default to Windows/PowerShell, and Linux CLI parity is not always explicit.
Recommendations
- Ensure all example commands are provided in both Azure CLI and PowerShell, with CLI (cross-platform) examples shown first.
- Where Windows-specific tools (Sysprep, Hyper-V) are mentioned, provide equivalent Linux instructions (waagent, etc.) with equal prominence and detail.
- Avoid linking primarily to Windows/PowerShell documentation; provide direct links to Linux/CLI documentation where available.
- Explicitly call out Linux/macOS compatibility and provide troubleshooting steps/examples for those platforms.
- Review and update references to ensure Linux and Windows are treated equally in all scenarios, including FAQs and advanced scenarios.
Create Pull Request