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
⚠️
missing_linux_example
⚠️
powershell_heavy
Summary:
The documentation page demonstrates a Windows bias in several ways: Windows and PowerShell are referenced more frequently and often before Linux equivalents. Many example links and guidance for advanced scenarios (e.g., restoring with custom images, availability sets, network configurations) point to Windows-specific documentation or PowerShell usage, while Linux or cross-platform alternatives are missing or only mentioned in passing. Some post-restore steps and troubleshooting commands are provided only for Windows (e.g., bcdedit, netdom), with no Linux equivalents or guidance.
Recommendations:
- Provide parallel Linux examples and links (e.g., for restoring VMs with custom images, availability sets, or special network configurations, include Linux documentation and CLI/Bash examples).
- When referencing PowerShell, also provide Azure CLI or Bash alternatives for all major operations, especially for VM creation and disk attachment.
- In post-restore steps, include Linux-specific troubleshooting and recovery guidance (e.g., how to reset SSH keys, repair bootloaders, or rejoin a Linux VM to a domain or directory service).
- Avoid linking only to Windows-specific documentation (such as /windows/ URLs); always include or prioritize Linux or cross-platform links where available.
- Explicitly mention any differences or additional steps required for Linux VMs in scenarios such as restoring SQL VMs, domain controllers, or VMs with special configurations.
- Ensure that screenshots and UI walkthroughs are not Windows-centric, and clarify when steps are identical for Linux VMs.
Create pull request