Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides parallel instructions for Azure Portal, PowerShell, CLI, and Terraform, but PowerShell (a Windows-centric tool) is given a dedicated section with extensive, step-by-step examples. PowerShell instructions are detailed and appear before CLI examples, which are more cross-platform. There is a slight preference for Windows tools and patterns, with PowerShell cmdlets and guidance on installing/updating Azure PowerShell modules. However, Linux parity is generally maintained via CLI and Terraform examples, and the VM creation examples use Ubuntu images.
Recommendations
- Present CLI examples before PowerShell, as CLI is more cross-platform.
- Explicitly mention that Azure CLI works natively on Linux/macOS and provide installation instructions for those platforms.
- Add notes or links for Linux/macOS users on how to use Azure Cloud Shell or install Azure CLI locally.
- Balance the level of detail between PowerShell and CLI sections to avoid giving the impression that PowerShell is the preferred or primary method.
- Where PowerShell-specific troubleshooting or module installation is discussed, provide equivalent guidance for CLI on Linux/macOS.
Create Pull Request