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
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates several forms of Windows bias. Windows-specific tools and patterns (such as PowerShell and OS disk swap documentation linking to Windows-specific pages) are mentioned before or instead of Linux equivalents. Step-by-step instructions and automation examples reference PowerShell, but there are no corresponding CLI or Linux-native examples. The Linux-specific restore process is relegated to a separate, brief step, and lacks detailed guidance or parity with the Windows instructions.
Recommendations:
- Provide equivalent Linux examples alongside Windows/PowerShell instructions, such as using Azure CLI or Bash scripts for restoring VMs and creating new instances from restored disks.
- When referencing features like OS disk swap, include links and instructions for both Windows and Linux VMs, or clarify any differences.
- Avoid presenting Windows tools (e.g., PowerShell) as the default or only automation method; always offer cross-platform alternatives.
- Expand the Linux restore section to include detailed, step-by-step instructions, matching the depth provided for Windows.
- Ensure that all screenshots, notes, and linked resources are inclusive of both operating systems, or clearly indicate when a process is OS-specific.
Create pull request