Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Azure CLI and PowerShell examples, but PowerShell is given equal prominence as CLI, and deployment instructions for ARM and Bicep templates mention PowerShell tools (New-AzResourceGroupDeployment) alongside CLI. There is no explicit Linux/macOS bias, but the presence of PowerShell and Windows-specific tooling may create friction for Linux users. The portal instructions are platform-neutral, but PowerShell is a Windows-centric tool, and its mention may imply a Windows-first approach.
Recommendations
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and recommend CLI for cross-platform usage.
- List CLI examples before PowerShell examples to reduce Windows-first perception.
- For ARM and Bicep deployment, highlight az deployment group create as the primary method, and mention PowerShell as an alternative for Windows users.
- Add notes clarifying that PowerShell Core is available on Linux/macOS, if PowerShell usage is necessary.
- Consider adding bash script examples for Linux users where relevant.
Create Pull Request