Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a bias toward Windows environments by providing PowerShell examples first and in greater detail, especially in the ARM template deployment section. The initial deployment instructions use Azure PowerShell in Cloud Shell, with no equivalent Azure CLI (Linux-friendly) example for ARM template deployment. The Bicep section does offer both CLI and PowerShell, but PowerShell is still presented as an option. There is an absence of explicit Linux shell (bash) instructions for ARM template deployment, and Windows/PowerShell terminology appears before Linux/CLI alternatives. The SSH key note references Linux paths, but overall, deployment guidance is Windows/PowerShell-centric.
Recommendations
- Add Azure CLI (bash) examples for ARM template deployment alongside PowerShell, especially in the ARM template section.
- Present CLI (Linux-friendly) instructions before or alongside PowerShell instructions to avoid Windows-first ordering.
- Explicitly mention that Azure Cloud Shell supports both bash and PowerShell, and provide instructions for both.
- Ensure all steps (copy/paste, resource deletion, etc.) have CLI equivalents, not just PowerShell.
- Consider adding a table or tabs that let users choose their preferred environment (CLI/bash, PowerShell, etc.) for all deployment and management tasks.
Create Pull Request