Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a significant Windows bias. All command-line examples use PowerShell cmdlets (e.g., New-AzResourceGroup, New-AzResourceGroupDeployment, Remove-AzResource), which are native to Windows and require either Windows or PowerShell Core on Linux/macOS. There are no equivalent Azure CLI or bash examples provided for Linux/macOS users. The troubleshooting section also references PowerShell modules exclusively. The documentation assumes familiarity with Windows tooling and does not mention Linux-native alternatives or provide guidance for non-Windows environments.
Recommendations
- Add equivalent Azure CLI examples for all PowerShell commands, ensuring Linux/macOS users can follow along without installing PowerShell.
- Explicitly mention that PowerShell Core can be installed on Linux/macOS, or recommend Azure CLI as the preferred cross-platform tool.
- Reorder examples so that Azure CLI (cross-platform) is shown first, or at least in parallel with PowerShell.
- Include troubleshooting steps using Azure CLI and reference Linux/macOS compatibility.
- Clarify any OS-specific limitations or requirements, especially in the context of autoscale metrics and deployment tooling.
Create Pull Request