Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page demonstrates a Windows bias in its 'Next steps' section by listing Azure PowerShell and Visual Studio Code (VS Code) as the primary tools for deploying and authoring Bicep files. Azure PowerShell is a Windows-centric tool, and VS Code is often associated with Windows workflows. There is no mention of Linux-native alternatives (e.g., Bash, cloud shell, or Linux editors), nor are Linux-specific deployment instructions or examples provided. The examples themselves are platform-neutral, but the guidance for running them favors Windows environments.
Recommendations
- Include explicit instructions and examples for deploying Bicep files using Azure CLI in Bash or other Linux shells.
- Mention Linux-native editors (such as Vim, Emacs, or VS Code on Linux) for authoring Bicep files.
- Add links or references to documentation for running Bicep deployments in Azure Cloud Shell, which is platform-agnostic.
- Ensure that both Azure CLI and Azure PowerShell are presented equally, or list Azure CLI first to avoid Windows-first bias.
- Clarify that Bicep is cross-platform and can be used on Windows, Linux, and macOS.
Create Pull Request