Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides examples for Azure CLI, Azure PowerShell, and the Azure Portal, but does not include any explicit Linux shell (bash, zsh, etc.) or scripting examples. Azure PowerShell is a Windows-centric tool, and its inclusion alongside CLI in every example reinforces a Windows bias. The ordering of examples (CLI first, then PowerShell, then Portal) is common, but the lack of Linux-specific instructions or notes (such as bash scripting, environment differences, or cross-platform considerations) means Linux users may not see their workflows represented.
Recommendations
- Add explicit bash/zsh shell examples for running Azure CLI commands, including notes about authentication and environment setup on Linux.
- Include information about installing and using Azure CLI on Linux, and clarify that all CLI examples are cross-platform.
- Where PowerShell examples are given, clarify that PowerShell Core is available on Linux and macOS, or provide bash alternatives.
- Add troubleshooting notes for common Linux issues (e.g., quoting, environment variables, authentication differences).
- Consider including a 'Platform compatibility' note at the top of the page, specifying which tools are available on which OSes.
Create Pull Request