Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all deployment and management tasks, but PowerShell examples are always shown immediately after CLI and use Windows-centric variable syntax (e.g., arrays with @()). There is no explicit mention of Linux/macOS shell equivalents for variable assignment, nor any guidance for Bash users on how to adapt PowerShell examples. The CLI examples are cross-platform, but the variable assignment syntax shown (single-quoted, parenthesized lists) is not standard Bash and may confuse Linux/macOS users.
Recommendations
- Add explicit Bash/Linux/macOS variable assignment examples for all CLI commands, using standard Bash array or string syntax.
- Clarify that Azure CLI commands work on all platforms and provide platform-specific notes where variable syntax differs.
- Reorder examples to show CLI (cross-platform) first, and PowerShell (Windows-centric) second, with clear headings.
- Add a note or section explaining differences in variable assignment between PowerShell and Bash, with examples.
- Review and update sample variable assignments to use syntax that works natively in Bash/zsh (e.g., myContactEmails='user1@contoso.com user2@contoso.com' or as an array).
Create Pull Request