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 exhibits mild Windows bias. In the 'ResourceGroupNotFound' error, both Azure CLI and PowerShell are mentioned, but PowerShell is listed after CLI, which is positive. However, throughout the page, there are several instances where Windows-specific links or tools are mentioned either before or more prominently than Linux equivalents. For example, in the 'AllocationFailed' error, the link to Linux troubleshooting is listed before Windows, which is good, but in 'SubnetsNotInSameVnet', the Windows VM link is listed before the Linux VM link. Additionally, PowerShell is referenced as a primary tool for context management, and there are no explicit Linux shell (bash) or cross-platform command examples. There is also a general lack of Linux-specific command-line examples or references to bash/Unix tools, and no mention of cross-platform scripting approaches.
Recommendations:
- Ensure that Linux and Windows examples/links are always presented together and alternate which comes first, or use alphabetical order.
- Include bash/Azure CLI examples and references alongside PowerShell, especially for common operations like setting context.
- Where PowerShell is mentioned, clarify that it is available cross-platform, or provide equivalent bash/CLI commands.
- Audit all links to ensure Linux and Windows parity, and avoid listing Windows tools or documentation first by default.
- Add explicit Linux troubleshooting steps or references where only Windows tools or approaches are mentioned.
Create pull request