Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides detailed step-by-step instructions for Azure Portal and Azure PowerShell, but omits equivalent Azure CLI examples, which are more commonly used on Linux/macOS. PowerShell is featured prominently, and instructions for PowerShell appear before any mention of CLI. This creates friction for Linux/macOS users who may not have access to PowerShell or prefer CLI/bash workflows.
Recommendations
- Add Azure CLI examples for all major steps (exporting, modifying, and deploying templates) alongside PowerShell and Portal instructions.
- Ensure CLI instructions are presented with equal prominence and detail as PowerShell, ideally in parallel tabbed sections.
- Where region codes are discussed, show how to obtain them using Azure CLI (e.g., 'az account list-locations').
- Explicitly note that PowerShell commands can be run on Linux/macOS, but recommend CLI for those platforms.
- Review all sections for references to Windows-specific tools or workflows and provide Linux/macOS alternatives.
Create Pull Request