Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation provides examples for Azure Portal, ARM templates, Azure CLI, and PowerShell, but there is a notable emphasis on PowerShell, which is primarily a Windows tool. PowerShell examples are given equal prominence as Azure CLI, and in some cases, PowerShell is the only scripting example provided (e.g., secret definition and referencing). There are no explicit Linux shell (bash) examples, nor is there mention of Linux-specific tooling or patterns. Additionally, certain features (such as Key Vault secret references and secret volume mounts) are explicitly stated as unsupported in PowerShell, but there is no guidance for Linux users or alternatives for those scenarios.
Recommendations
- Add explicit bash examples alongside Azure CLI commands to demonstrate usage in Linux environments.
- Clarify that Azure CLI commands are cross-platform and provide sample shell environment variable usage (e.g., export, $VAR) for Linux.
- Reduce reliance on PowerShell for scripting examples, or provide equivalent bash scripts for each PowerShell example.
- Mention Linux-specific considerations (such as file permissions when mounting secrets as volumes) where relevant.
- Where features are unsupported in PowerShell, provide alternative instructions for Linux users (e.g., using Azure CLI or ARM templates).
- Include a note at the beginning of the documentation clarifying platform support and parity for all examples.
Create Pull Request