Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a bias toward Windows environments by exclusively providing PowerShell commands for Azure CLI operations, stating that PowerShell is used for the tutorial, and using Windows-style variable assignment and scripting patterns. There are no Bash or Linux shell equivalents for key steps such as resource group setup, storage account creation, role assignment, and cleanup, even though Azure CLI is cross-platform. The only Bash example is for the Python SDK usage and job status retrieval, which is not sufficient for full Linux parity.
Recommendations
- Provide Bash/Linux shell equivalents for all Azure CLI commands, especially for resource setup, role assignment, and cleanup.
- Clarify that Azure CLI commands work on both Windows and Linux, and avoid stating that PowerShell is the default unless necessary.
- Present both PowerShell and Bash examples side-by-side, or allow users to select their preferred shell in the documentation.
- Avoid using Windows-specific variable assignment syntax (e.g., $Variable) without offering the Linux alternative (e.g., export VARIABLE=value).
- Include a note or section for Linux/macOS users to ensure inclusivity and usability across platforms.
Create Pull Request