About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
powershell_heavy
Summary:
The documentation provides environment variable setup instructions for Windows (cmd and PowerShell) before Linux/macOS, and includes both Windows Command Prompt and PowerShell commands. Linux/macOS instructions are present but always listed last. There are no missing Linux examples, but the ordering and inclusion of multiple Windows-specific shells (cmd, PowerShell) compared to a single Linux shell (bash) demonstrates a subtle Windows-first and PowerShell-heavy bias.
Recommendations:
- Alternate the order of OS instructions (sometimes list Linux/macOS first, or use tabs for OS selection).
- Group all OS instructions under clearly labeled tabs (Windows, Linux/macOS) to avoid implicit prioritization.
- Provide parity in shell instructions: if both cmd and PowerShell are shown for Windows, consider mentioning both bash and zsh for Linux/macOS, or clarify that bash commands work for most shells.
- Explicitly state that all platforms are supported equally at the start of the relevant sections.
- Consider using cross-platform tools (like Azure CLI) for setup steps where possible, and highlight their usage.
Create pull request