Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits a strong Windows bias. While initial steps use Azure CLI (which is cross-platform), all example commands and outputs are shown in PowerShell syntax, with variables using $-prefix and cmdlets (e.g., New-AzureStorageContext, Start-AzureStorageBlobCopy, Get-AzureStorageBlobCopyState) that are exclusive to Windows PowerShell/Azure PowerShell. There are no Bash or Linux/macOS shell equivalents for these steps, nor is there guidance for Linux users on how to perform the critical VHD export and copy operations. The examples and outputs are consistently presented in a Windows/PowerShell context, and Windows images are listed first and in greater detail than Linux images.
Recommendations
- Provide equivalent Bash/Azure CLI examples for all steps, especially for exporting VHDs and copying blobs, using az storage blob copy or azcopy.
- Clarify which steps require PowerShell and offer alternatives for Linux/macOS users.
- Show example outputs from Bash/Azure CLI, not just PowerShell.
- List Linux images alongside Windows images in the 'Commonly used Marketplace images' table, and consider presenting them in a more balanced order.
- Explicitly state platform requirements for any Windows-only tools, and link to cross-platform alternatives.
Create Pull Request