Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation page presents both Azure PowerShell and Azure CLI examples for deploying ARM templates, but the PowerShell example is shown first and is more visually prominent. The prerequisite section lists 'Azure PowerShell or the Azure CLI', but the deployment instructions and code tabs consistently place PowerShell before CLI. There are no Linux-specific instructions, nor is there mention of Linux tooling or shell patterns (e.g., Bash, zsh). The verification and cleanup steps focus on the Azure portal, which is cross-platform, but the command-line guidance leans toward Windows/PowerShell usage.
Recommendations
- Alternate the order of PowerShell and CLI examples, or present CLI examples first to avoid implicit Windows-first bias.
- Explicitly mention that Azure CLI works natively on Linux/macOS and provide shell-specific usage notes (e.g., Bash variable syntax).
- Include example commands for Bash/zsh where variable assignment or command syntax may differ from PowerShell.
- Add a note clarifying that both Azure PowerShell and Azure CLI are cross-platform, and link to installation instructions for Linux/macOS.
- Where variables are referenced (e.g., $templateFile), show both PowerShell and Bash syntax for setting and using variables.
Create Pull Request