Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a clear Windows bias. Most command examples use PowerShell syntax and variables (e.g., $urn, $diskName), and rely on Azure PowerShell-specific cmdlets such as New-AzureStorageContext and Start-AzureStorageBlobCopy, which are not available on Linux. The workflow and examples consistently use Windows images first and in more detail, with Linux images (Ubuntu) mentioned only briefly and without corresponding step-by-step examples. There are no Linux shell (bash) equivalents for the PowerShell commands, nor are cross-platform alternatives for storage context or blob copy operations provided.
Recommendations
- Provide equivalent bash shell examples for all steps, especially for exporting VHDs and copying blobs, using az CLI and native Linux tools.
- List Linux images (e.g., Ubuntu, CentOS) alongside Windows images in the 'Commonly used Marketplace images' table, with parity in detail.
- Replace or supplement PowerShell-specific commands (e.g., New-AzureStorageContext, Start-AzureStorageBlobCopy) with az CLI or REST API examples that work on Linux/macOS.
- Explicitly state cross-platform compatibility in prerequisites and workflows, and avoid assuming PowerShell as the default shell.
- Include example outputs from Linux environments to demonstrate parity.
Create Pull Request