Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Azure PowerShell and Azure CLI examples for all major operations, but PowerShell examples are consistently listed before CLI examples. This ordering, along with the detailed PowerShell command usage, reflects a subtle Windows-first bias. There are no Linux-specific tools or shell patterns (e.g., Bash scripting, environment variables) beyond the CLI, and no explicit mention of Linux environments or considerations. The documentation does not provide examples using Linux-native tools, nor does it discuss platform-specific differences or troubleshooting for Linux users.
Recommendations
- Alternate the order of PowerShell and CLI examples, or present CLI examples first to better support Linux users.
- Explicitly mention that Azure CLI commands work natively on Linux, macOS, and Windows, and provide guidance for installing and using Azure CLI on Linux.
- Add notes or sections addressing platform-specific considerations, such as file path formats, shell environments, or troubleshooting steps for Linux users.
- Where possible, include Bash scripting examples for automation, and reference Linux-native tools or workflows.
- Clarify that PowerShell Core is cross-platform, but distinguish between Windows PowerShell and PowerShell Core if relevant.
Create Pull Request