Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by providing examples and instructions only for Azure CLI and Azure PowerShell, with no mention of Linux-native tools or shell environments (e.g., Bash). The tooling recommendations focus on Visual Studio Code and Visual Studio, both of which are traditionally Windows-centric (though VS Code is cross-platform). There are no Bash or Linux shell command examples, nor is there guidance for using the Bicep CLI directly in a Linux environment. PowerShell examples are given equal prominence to Azure CLI, and Windows tools are referenced throughout, with no explicit Linux alternatives.
Recommendations
- Add Bash shell examples for all Azure CLI commands, demonstrating usage in a Linux environment.
- Explicitly mention that Azure CLI commands can be run in Bash on Linux/macOS, and provide sample commands using Bash variables and syntax.
- Include instructions for installing and using Bicep CLI on Linux and macOS, not just Windows.
- Reference Linux-native editors (e.g., Vim, nano) for editing Bicep files, or clarify that VS Code is available cross-platform.
- Avoid presenting PowerShell examples before or alongside CLI examples unless parity is maintained for Linux users.
- Add a section or note on cross-platform compatibility, highlighting any differences or considerations for Linux/macOS users.
Create Pull Request