Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides examples for Azure CLI, Azure PowerShell, and Azure Portal, but the command-line examples are limited to Azure CLI and PowerShell. PowerShell is a Windows-centric tool, and its inclusion alongside CLI in every example (with no Bash, shell script, or Linux-specific guidance) demonstrates a bias toward Windows users. Additionally, PowerShell examples are always present and sometimes listed before CLI, reinforcing a Windows-first approach. There are no Linux-specific instructions, troubleshooting notes, or alternative shell examples.
Recommendations
- Add Bash or shell script examples for Linux users where appropriate, especially for scripting scenarios.
- Clarify that Azure CLI is cross-platform and provide explicit instructions for installing and using it on Linux and macOS.
- Where PowerShell is referenced, note that PowerShell Core is available cross-platform, and provide guidance for Linux/macOS installation and usage.
- Include troubleshooting notes or tips for common Linux-specific issues (e.g., permissions, environment variables, path differences).
- Ensure that CLI examples are listed before PowerShell to avoid implicit Windows-first ordering.
- Consider referencing automation tools popular on Linux (e.g., cron jobs, systemd) for event handling, where relevant.
Create Pull Request