Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides examples for Azure CLI and Azure PowerShell, but PowerShell is a Windows-centric shell, and there are no explicit Bash or Linux shell examples. The environment variable setup and token extraction steps use PowerShell syntax in the PowerShell tab, which is not portable to Linux/macOS. The documentation does not mention Linux-specific tools or patterns, nor does it provide parity for Linux users in the PowerShell sections. The use of PowerShell is presented as an alternative to Azure CLI, but not as a cross-platform shell, and there is no explicit guidance for Linux or macOS users.
Recommendations
- Add explicit Bash/Linux shell examples alongside PowerShell, especially for environment variable setup and token extraction.
- Clarify that Azure CLI commands work on Linux/macOS and provide any necessary platform-specific notes.
- For steps that use PowerShell-specific syntax (e.g., token extraction), provide equivalent Bash commands.
- Include a 'Linux/macOS' tab or section for users who do not use PowerShell.
- Avoid implying PowerShell is the default or only alternative to Azure CLI; mention Bash as the primary shell for Linux/macOS.
Create Pull Request