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
⚠️
windows_tools
⚠️
powershell_heavy
Summary:
The documentation demonstrates a Windows bias by prioritizing or exclusively mentioning Windows-specific tools, examples, and workflows. Windows and PowerShell are referenced more frequently and earlier than Linux equivalents. There are missing Linux-specific examples, and guidance for Linux users is minimal or absent, especially in advanced or troubleshooting scenarios.
Recommendations:
- Provide Linux-specific examples alongside Windows ones, especially for tasks like restoring VMs, attaching disks, and post-restore steps.
- Include references to Azure CLI and Bash scripts, not just PowerShell, for automation and VM creation from restored disks.
- When mentioning Windows tools (e.g., bcdedit, netdom), also provide equivalent Linux troubleshooting steps (e.g., using GRUB, chroot, SSH recovery).
- Balance references to Windows and Linux documentation, such as linking to both Windows and Linux VM management guides.
- Explicitly state when a process or feature is OS-agnostic, and clarify any OS-specific limitations or requirements.
- Add Linux-focused troubleshooting and post-restore guidance, such as handling cloud-init, resetting SSH keys, or repairing bootloaders.
Create pull request