Document Details
Common Deployment Errors
❌
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
⚠️
powershell_heavy
⚠️
windows_tools
Summary:
The documentation page demonstrates a mild Windows bias. In the 'ResourceGroupNotFound' error, both Azure CLI and PowerShell are mentioned, but PowerShell is listed second, which is acceptable. However, in other areas, such as the 'SubnetsNotInSameVnet' error, the Windows VM documentation link is listed before the Linux VM equivalent. Additionally, there are no explicit Linux shell (bash) command examples or references to Linux-native tools, and PowerShell is referenced as a primary tool for context management. There are no Linux-specific troubleshooting patterns or examples, and Windows terminology (such as PowerShell) appears more frequently or with higher prominence.
Recommendations:
- Ensure that for every PowerShell example or reference, an equivalent Azure CLI (bash-friendly) example is provided and listed first or side-by-side.
- When linking to OS-specific documentation (e.g., multiple NICs for VMs), alternate the order or present both Windows and Linux links together, or list Linux first to balance historic bias.
- Include Linux-native troubleshooting tools or commands where relevant, not just PowerShell.
- Audit for any missing Linux-specific troubleshooting scenarios and add them where appropriate.
- Use neutral language when referring to command-line tools (e.g., 'Azure CLI or PowerShell') and avoid defaulting to Windows-first terminology.
Create pull request