Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both PowerShell and Azure CLI examples for deploying ARM templates, but consistently lists PowerShell (a Windows-centric tool) before Azure CLI in every example. There are no Linux-specific shell examples (e.g., Bash), and the clean-up instructions reference only the Azure Portal, not command-line options. The prerequisites mention both Azure PowerShell and CLI, but PowerShell is always presented first, which may subtly prioritize Windows users.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI examples first to better support Linux/macOS users.
- Explicitly mention that Azure CLI commands work cross-platform (Windows, Linux, macOS), and consider providing Bash-specific command examples where appropriate.
- Include command-line instructions for resource clean-up using both Azure CLI and PowerShell, not just Azure Portal steps.
- Where possible, clarify that Visual Studio Code and the Azure Resource Manager Tools extension are cross-platform.
- Add a note or section highlighting that all tasks can be performed on Linux/macOS as well as Windows.
Create Pull Request