Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a notable 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 a Windows environment or installation of PowerShell Core on Linux/macOS. There are no equivalent examples using Azure CLI, Bash, or other cross-platform tools. The troubleshooting section also references PowerShell modules (Get-AzMetric) exclusively. Windows terminology and tools are presented first and exclusively, with no mention of Linux/macOS alternatives or parity.
Recommendations
- Provide equivalent Azure CLI examples for all PowerShell commands, as Azure CLI is cross-platform and widely used on Linux/macOS.
- Explicitly mention that PowerShell Core can be installed on Linux/macOS, but recommend Azure CLI for native experience.
- Add Bash script examples for resource group and cluster deployment steps.
- Include troubleshooting steps using Azure CLI or REST API, not just PowerShell.
- Clarify any OS-specific limitations (e.g., the note about Windows OS image and Hyper-V) and provide Linux-specific guidance where relevant.
Create Pull Request