Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation consistently presents Azure PowerShell examples before Azure CLI examples in every code block, and uses PowerShell-specific syntax (backticks, parameter casing) throughout. This ordering and syntax may implicitly favor Windows users, as PowerShell is most commonly associated with Windows environments. There are no explicit Linux shell examples (e.g., bash, zsh), nor any mention of Linux-specific considerations, even though Azure CLI is cross-platform and commonly used on Linux. The documentation does not provide parity for Linux users in terms of command-line patterns, shell syntax, or troubleshooting tips.
Recommendations
- Alternate the order of PowerShell and CLI examples, or present CLI examples first to reflect cross-platform usage.
- Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and provide shell-specific notes where relevant.
- Where PowerShell syntax is shown, also provide equivalent bash/zsh syntax for multi-line commands (e.g., use '\' for line continuation in bash).
- Add troubleshooting notes for common issues on Linux (e.g., file permissions, environment variables, CLI installation).
- Clarify that PowerShell is available on Linux, but most Linux users prefer Azure CLI, and link to installation guides for both environments.
- Ensure that all examples are tested and work as written on Linux shells, and note any differences in output formatting or behavior.
Create Pull Request