Bias Analysis
Detected Bias Types
powershell_heavy
missing_linux_example
windows_tools
windows_first
Summary
The documentation page demonstrates a strong bias toward Windows and PowerShell environments. All command-line examples use Azure PowerShell, with no mention or example of Azure CLI (which is cross-platform and preferred on Linux/macOS). The instructions and code blocks assume the use of PowerShell, and there are no Bash or Linux-native shell examples. The validation and cleanup steps also rely exclusively on PowerShell commands. While the Azure Cloud Shell is cross-platform, the exclusive use of PowerShell commands and terminology (e.g., Write-Host, Read-Host) reinforces a Windows-centric approach. There is no guidance or parity for Linux users who may prefer Bash and Azure CLI.
Recommendations
- Add equivalent Azure CLI (az) command examples for all deployment, validation, and cleanup steps, using Bash syntax.
- Explicitly mention that Azure Cloud Shell supports both PowerShell and Bash, and provide instructions for both.
- Where PowerShell-specific commands are shown, offer side-by-side or tabbed examples for Bash/Azure CLI.
- Review terminology and instructions to ensure they are not PowerShell- or Windows-specific (e.g., avoid Write-Host, Read-Host in Bash examples).
- Include a note at the start of the 'Deploy the template' section indicating that both PowerShell and Bash/CLI options are available.
Create Pull Request