Document Details
Migrate Support Matrix Physical Migration
❌
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
⚠️
windows_tools
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by presenting Windows-specific tools, requirements, and connection instructions before or in more detail than their Linux equivalents. Windows terminology (such as BitLocker, Windows Firewall, RDP) is used extensively, and Linux instructions are less detailed or appear after Windows instructions. There is also a lack of parity in troubleshooting and configuration guidance for Linux systems.
Recommendations:
- Provide Linux connection instructions with equal detail and prominence as Windows (e.g., include firewall configuration commands for common Linux distributions, not just a generic SSH mention).
- When listing requirements or steps, alternate the order or present Windows and Linux instructions side-by-side to avoid always listing Windows first.
- Include examples for both Windows and Linux for tasks like enabling remote access, configuring firewalls, and preparing disks.
- Mention Linux-specific tools and scenarios (e.g., SELinux, iptables, firewalld, LUKS encryption) where Windows-specific tools (like BitLocker or Windows Firewall) are referenced.
- Expand on Linux filesystem and bootloader support, and provide troubleshooting steps for common Linux migration issues.
- Ensure parity in post-migration steps for both Windows and Linux, such as guidance for fixing boot issues, network configuration, and user access.
Create pull request