Document Details
Devtest Lab Add Vm
❌
This page contains Windows bias
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
⚠️
powershell_heavy
Summary:
The documentation demonstrates a Windows-first bias by using a Windows 11 Pro image as the default example for VM creation, without mentioning or illustrating Linux-based images. Additionally, the only explicit script-based workflow for copying VMs into a lab uses a PowerShell script, with no Linux or cross-platform alternative provided. There are no Linux-specific instructions, screenshots, or examples, and the documentation does not mention SSH or Linux authentication methods, focusing instead on password and Key Vault secrets typical for Windows environments.
Recommendations:
- Include Linux-based VM creation examples alongside or before Windows examples, such as using Ubuntu or other popular Linux distributions.
- Provide equivalent Linux command-line instructions (e.g., Bash scripts or Azure CLI examples) for tasks currently shown only with PowerShell, such as copying VMs into a lab.
- Mention Linux authentication options (e.g., SSH keys) in the basic settings section, and update screenshots to reflect both Windows and Linux VM creation flows.
- Clarify that both Windows and Linux images are supported and highlight any differences in configuration steps.
- Ensure that artifact examples and repository links include Linux-relevant artifacts and not just Windows-centric tools.
Create pull request