About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
missing_linux_example
⚠️
windows_tools
⚠️
powershell_heavy
Summary:
The documentation demonstrates a Windows bias by focusing primarily on Windows-based tooling and workflows (Hyper-V Manager, PowerShell) for preparing and converting Linux images. Linux-native hypervisors and tools (such as KVM, qemu-img, or Linux CLI workflows) are only briefly mentioned or referenced as alternatives, without step-by-step guidance. The primary example assumes a Windows host and does not provide equivalent Linux-based instructions.
Recommendations:
- Add a parallel section detailing how to prepare, convert, and upload a Linux image using Linux-native tools (e.g., KVM, qemu-img, libvirt, and Linux CLI).
- Provide step-by-step instructions for creating and converting VHDs on Linux, including commands for qemu-img and guidance for managing disk formats and sizes.
- Include examples of uploading VHDs to Azure from a Linux environment, using tools like AzCopy for Linux, Azure CLI, or REST APIs.
- Ensure that Linux-based workflows are presented with equal prominence and detail as Windows-based workflows, ideally in side-by-side or clearly separated sections.
- Reference Linux documentation and tools first or equally, rather than defaulting to Windows/Hyper-V as the primary workflow.
Create pull request