Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all major operations. However, PowerShell examples are given equal prominence and detail as CLI, despite PowerShell being primarily a Windows tool. In some sections, PowerShell examples appear immediately after CLI, and REST examples are included only for listing shared galleries, not for update or delete operations. There are no Linux-specific shell examples (e.g., bash scripting), and PowerShell is presented as a cross-platform option, which may not reflect typical Linux/macOS usage patterns.
Recommendations
- Clarify that PowerShell is available cross-platform, but most Linux/macOS users prefer bash or shell scripting with Azure CLI.
- Add explicit bash/zsh shell script examples for common Linux/macOS workflows, especially for tasks involving variables, loops, or output parsing.
- Consider including REST API examples for update and delete operations to provide a platform-neutral alternative.
- Where PowerShell is presented, note its installation and usage on Linux/macOS, or link to guidance for non-Windows users.
- If possible, show CLI examples using both Windows (cmd/PowerShell) and Linux/macOS (bash/zsh) syntax for variable assignment and command chaining.
Create Pull Request