Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides three pivots: Azure Portal, PowerShell, and Azure CLI. The PowerShell section is extensive and detailed, with step-by-step instructions and code samples, reflecting a bias toward Windows-centric tooling. The PowerShell pivot is presented before the CLI pivot, and there is significant emphasis on Azure PowerShell and Cloud Shell, which are most commonly used on Windows. There is no mention of Linux-specific shell environments, nor are there any bash or shell script examples. The CLI instructions are present but less emphasized, and the documentation does not discuss Linux-specific considerations or parity.
Recommendations
- Add explicit bash or shell script examples for Linux users, especially for Azure CLI commands.
- Mention that Azure CLI can be installed and run natively on Linux and macOS, and provide links or instructions for those platforms.
- Ensure that CLI instructions are as detailed and prominent as PowerShell instructions.
- Include notes about using Azure Cloud Shell from Linux/macOS terminals, not just from the Azure Portal.
- Consider reordering pivots or providing a neutral order (e.g., Portal, CLI, PowerShell) to avoid Windows-first impression.
- Add troubleshooting or environment setup notes for Linux users where relevant.
Create Pull Request