Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation demonstrates a Windows bias by providing detailed PowerShell examples and referencing PowerShell cmdlets, which are primarily used on Windows. The PowerShell tab and examples are presented before the Azure CLI tab, and there is no mention of Linux-specific tools or shell environments. While Azure CLI is cross-platform, the documentation does not explicitly provide Linux shell examples or address Linux-specific usage patterns. There are no Bash or Linux-native command examples, and the PowerShell approach is given prominence.
Recommendations
- Add explicit Bash/Linux shell examples for Azure CLI commands, including sample shell syntax and environment notes.
- Reorder the example tabs so that Azure CLI (which is cross-platform) appears before PowerShell, or at least clarify that CLI examples work on Linux, macOS, and Windows.
- Mention that PowerShell examples are primarily for Windows users, and provide guidance for Linux users (e.g., using Azure CLI or Azure Cloud Shell).
- Include notes or sections about using these commands in Linux environments, such as running Azure CLI in Bash or using ARM templates with Linux tools.
- Where possible, avoid Windows-centric terminology or tools unless necessary, and strive for parity in instructions for both Windows and Linux users.
Create Pull Request