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.