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 Marketplace image search includes both Windows and Ubuntu examples, all subsequent command-line examples use PowerShell syntax and Windows-specific Azure PowerShell modules (e.g., New-AzureStorageContext, Start-AzureStorageBlobCopy, Get-AzureStorageBlobCopyState). There are no Bash, Linux, or cross-platform CLI equivalents provided for critical steps such as exporting the VHD or copying blobs. The workflow implicitly assumes the user is on Windows or using PowerShell, creating friction for Linux/macOS users.
Recommendations
- Provide equivalent Bash/Azure CLI examples for all steps, especially for exporting VHDs and copying blobs.
- Explicitly mention cross-platform alternatives and tools (e.g., azcopy, Azure CLI storage commands) usable on Linux/macOS.
- Avoid using PowerShell variable syntax ($var) in generic CLI examples; use platform-neutral notation.
- Add a section or note clarifying which steps require PowerShell and how Linux/macOS users can accomplish them.
- Ensure that both Windows and Linux images are shown in parity in example tables and workflows.
Create Pull Request