Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by consistently presenting Azure PowerShell examples alongside Azure CLI, often giving PowerShell equal or greater prominence. There are no explicit Linux shell (bash) examples, and installation instructions focus on PowerShell and Azure CLI without mentioning Linux-specific details. The use of PowerShell syntax and terminology is pervasive, and Windows-centric tools (PowerShell) are featured as primary options for interacting with Bicep what-if operations. There is no mention of Linux-native scripting, nor are Linux-specific usage patterns (e.g., bash scripting, environment setup) provided.
Recommendations
- Add explicit bash (Linux shell) examples for all CLI commands, including variable assignment and output parsing.
- Include installation instructions for Azure CLI on Linux, and clarify cross-platform compatibility for all tools.
- When presenting command tabs, list Azure CLI (bash) first, then PowerShell, to avoid Windows-first ordering.
- Provide guidance for using what-if operations in Linux environments, including troubleshooting and environment setup.
- Mention that Azure CLI is cross-platform and highlight usage on Linux/macOS as well as Windows.
- Avoid PowerShell-exclusive code blocks for output parsing; provide equivalent bash/jq examples.
Create Pull Request