Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits a notable Windows bias. While the initial steps use Azure CLI (cross-platform), all example commands and outputs are shown in PowerShell syntax and context (e.g., PS /home/user> prompt, use of PowerShell variables, and PowerShell-specific cmdlets like New-AzureStorageContext and Start-AzureStorageBlobCopy). There are no bash or Linux/macOS shell equivalents for key steps such as copying the VHD to blob storage. The table of common images lists Windows images first and in greater detail. The workflow references Azure PowerShell in a key link, and the entire export/copy workflow is described only with Windows/PowerShell tools.
Recommendations
- Provide equivalent bash/Linux/macOS shell examples for all steps, especially for VHD export and blob copy (e.g., using azcopy or Azure CLI storage commands).
- Show both PowerShell and bash syntax for variable assignment and command execution.
- Include example outputs from Linux/macOS terminals (e.g., $ prompt, not PS /home/user>).
- List Linux images first or interleave them with Windows images in tables and examples.
- Reference cross-platform tools and workflows before or alongside Windows/PowerShell-specific ones.
Create Pull Request