Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides examples for Azure Portal, ARM templates, Azure CLI, and PowerShell. PowerShell is featured as a first-class command-line option, but there are no Linux/macOS-specific shell examples (e.g., Bash, zsh), nor are there any references to Linux-native tools or patterns. PowerShell examples are given equal or greater prominence than CLI, and some features (Key Vault secret references, secret volume mounts) are explicitly unsupported in PowerShell, but this is not balanced by Linux-specific guidance. The CLI examples are cross-platform, but the lack of Linux/macOS shell context or troubleshooting tips creates friction for non-Windows users.
Recommendations
- Add explicit Bash/zsh shell examples for Linux/macOS users, especially for environment variable handling and scripting.
- Clarify that Azure CLI commands are cross-platform and provide troubleshooting notes for common Linux/macOS issues (e.g., quoting, environment variable expansion).
- Where PowerShell is unsupported, offer Linux/macOS alternatives or workarounds.
- Reorder examples so CLI (cross-platform) appears before PowerShell, or group by OS context.
- Explicitly state platform compatibility for each method, especially where features are missing in PowerShell or only available via CLI/ARM.
Create Pull Request