Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides examples for Azure Portal, ARM template, Azure CLI, and PowerShell. PowerShell examples are included for most tasks, but there are no explicit Linux/macOS shell examples (e.g., Bash scripts), nor is there mention of Linux-specific tools or workflows. PowerShell is a Windows-centric tool, and its inclusion without equivalent Bash or shell examples creates a bias. Additionally, PowerShell examples are presented alongside CLI and ARM, but never after a Linux shell example. Some features (Key Vault secret references, secret volume mounts) are explicitly unsupported in PowerShell, but there is no guidance for Linux users in those cases.
Recommendations
- Add explicit Bash or Linux shell examples for all Azure CLI commands, showing environment variable usage and typical Linux workflows.
- Clarify that Azure CLI commands work cross-platform and provide notes or links for Linux/macOS installation and usage.
- Where PowerShell is unsupported (e.g., Key Vault secret references, secret volume mounts), provide alternative Linux/macOS guidance or explicitly state how to accomplish the task using Azure CLI or ARM templates.
- Consider reordering examples so that CLI (cross-platform) comes before PowerShell, or provide a Linux/macOS tab.
- Add troubleshooting notes for common Linux/macOS issues (permissions, file paths, etc.) when mounting secrets as volumes.
Create Pull Request