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:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation page demonstrates a Windows bias by providing PowerShell-based examples for disk migration and referencing Windows-specific tools and patterns (e.g., PowerShell, Windows VM with RDP) before Linux equivalents. The only command-line example for moving disks uses PowerShell, and while there is a brief mention of Linux VMs (with SSH port 22), there are no Linux shell (bash/CLI) examples for key steps such as using AzCopy or managing disks. The guidance for swapping OS disks links to a Windows/PowerShell article, with no Linux/CLI equivalent. The overall workflow assumes familiarity with Windows tools and environments, with Linux parity lacking in practical, step-by-step guidance.
Recommendations:
- Provide equivalent Bash/Azure CLI examples for all PowerShell commands, especially for disk migration and AzCopy usage.
- Include explicit Linux VM management steps and examples (e.g., swapping OS disks using Azure CLI or Bash).
- When showing code snippets for VM network configuration, present Linux and Windows examples side by side, not with Windows first.
- Reference both Windows and Linux documentation for advanced tasks (e.g., swapping OS disks) to ensure parity.
- Review all instructions to ensure that Linux users are equally supported and not required to translate PowerShell or Windows-centric steps themselves.
Create pull request