Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits several signs of Windows bias. Many example links and references point to Windows-specific guides (e.g., restoring VMs using PowerShell, attaching disks to Windows VMs, and managing IP addresses via PowerShell). Windows terminology and tools (PowerShell, bcdedit, netdom) are used in examples and troubleshooting steps, while Linux equivalents are missing or only briefly mentioned. Windows scenarios (Hybrid Use Benefit, SQL VMs, domain controllers) are described in detail, whereas Linux-specific restore scenarios are not covered. In post-restore steps, Windows commands are shown for fixing domain join issues, but Linux troubleshooting is limited to a brief mention of cloud-init and password reset.
Recommendations
- Provide Linux-specific examples and links for disk attachment, VM creation, and troubleshooting (e.g., using Azure CLI, Bash, or cloud-init).
- Include parity for Linux restore scenarios, such as restoring VMs with SSH keys, handling SELinux/AppArmor, and restoring Linux-based SQL or application servers.
- Add troubleshooting steps and commands for common Linux issues after restore (e.g., fixing broken fstab, network configuration, or agent installation).
- Present examples using Azure CLI and Bash alongside PowerShell, and avoid showing Windows tools first or exclusively.
- Clarify when instructions are OS-specific and offer alternatives for Linux/macOS users.
Create Pull Request