Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits a strong Windows bias. Most command-line examples use PowerShell syntax and variables (e.g., $urn, $diskName), and rely on Azure PowerShell-specific cmdlets (New-AzureStorageContext, Start-AzureStorageBlobCopy, Get-AzureStorageBlobCopyState) that are not available or typical on Linux/macOS. The workflow and examples consistently use Windows images first and in detail, with only brief mention of Ubuntu images. There are no equivalent Linux shell (bash) examples for key steps such as exporting the VHD, nor are cross-platform alternatives for Azure Storage operations provided.
Recommendations
- Provide full bash/Azure CLI examples for all steps, especially for exporting VHDs and managing storage blobs, using az storage commands.
- List Linux images (e.g., Ubuntu, CentOS, Red Hat) alongside Windows images in the 'Commonly used Marketplace images' table, and use a Linux image as the main example in at least one workflow.
- Replace PowerShell-specific syntax (e.g., $variables) with bash syntax (e.g., variable=value) in CLI examples, or provide both.
- Document cross-platform alternatives for Azure Storage operations, such as using az storage blob copy or azcopy, and clarify which commands work on Linux/macOS.
- Add explicit notes or sections for Linux/macOS users, including installation and usage of Azure CLI and azcopy.
Create Pull Request