Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation demonstrates a Windows bias by referencing PowerShell and Visual Studio Code as primary tools, providing explicit PowerShell deployment instructions, and mentioning the integrated VS Code terminal shortcut (which is Windows-specific). There are no explicit Linux shell (bash) examples, nor is there mention of Linux-specific editors or terminal usage. The Azure CLI example is present, but it is not clearly contextualized for Linux users, and the PowerShell tab appears before CLI in the deployment section.
Recommendations
- Add explicit bash shell examples for deploying the Bicep file on Linux/macOS.
- Mention Linux-compatible editors (e.g., Vim, Nano, VS Code on Linux) in the 'Review the Bicep file' section.
- Clarify that Azure CLI commands work cross-platform and provide terminal instructions for Linux/macOS (e.g., using 'cd' and './').
- Avoid referencing Windows-specific shortcuts (e.g., ctrl+` for VS Code) without noting Linux/macOS equivalents.
- Ensure that CLI examples are presented before PowerShell, or at least in parallel, to avoid Windows-first ordering.
Create Pull Request