Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation presents both Azure PowerShell and Azure CLI examples for deploying and reviewing resources. However, Azure PowerShell (a Windows-centric tool) is consistently listed first in all example tabs, and there are no explicit Linux/macOS shell examples (e.g., Bash, zsh). There is no mention of platform-specific considerations, nor are there instructions for installing or running Azure CLI/PowerShell on Linux/macOS. The documentation assumes parity but subtly prioritizes Windows tools and workflows.
Recommendations
- Alternate the order of example tabs so Azure CLI (cross-platform) appears first, or explicitly note that CLI is recommended for Linux/macOS users.
- Add a brief section on installing Azure CLI and Azure PowerShell on Linux/macOS, including links to official guides.
- Include explicit Bash/zsh shell examples for Linux/macOS users, especially for file operations (e.g., saving the Bicep file).
- Clarify that both Azure CLI and PowerShell are cross-platform, but CLI is natively available on Linux/macOS.
- Add troubleshooting notes for common Linux/macOS issues (e.g., file permissions, path separators).
Create Pull Request