Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a mild Windows bias. It references Azure PowerShell before Azure CLI when discussing error details, and provides PowerShell-specific command examples. There are no explicit Linux shell (bash) examples or references to Linux-specific troubleshooting tools or workflows. The guidance assumes Visual Studio Code as the editor, which is cross-platform, but does not mention alternative editors or command-line tools commonly used on Linux.
Recommendations
- Present Azure CLI examples before or alongside Azure PowerShell examples, as CLI is platform-agnostic and widely used on Linux.
- Include bash or shell script examples for common troubleshooting tasks, such as querying deployment operations or activity logs.
- Mention Linux-native editors (e.g., Vim, Emacs) or command-line validation tools for Bicep/ARM templates, if available.
- Clarify that Visual Studio Code and the listed extensions are available on Linux, and suggest installation instructions for Linux users.
- Ensure that troubleshooting steps and tools are described in a way that is not platform-specific, or explicitly provide parity for Linux environments.
Create Pull Request