Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and PowerShell examples for deploying Bicep files at the subscription scope. However, PowerShell (a Windows-centric tool) is given a dedicated section and is presented alongside Azure CLI, but there is no mention of Bash, Linux shell, or macOS-specific instructions. The references to Cloud Shell are generic and do not clarify Linux/macOS parity. The order of examples sometimes places PowerShell before or at equal prominence with CLI, which may subtly prioritize Windows workflows. There are no explicit Linux/macOS instructions or troubleshooting notes.
Recommendations
- Add explicit Bash/Linux/macOS shell examples for deployment commands, especially for Azure CLI usage.
- Clarify that Azure CLI commands work cross-platform and can be run from Bash, zsh, etc., on Linux/macOS.
- Where PowerShell is mentioned, note that PowerShell Core is available on Linux/macOS, and provide installation or usage links.
- Include troubleshooting notes or links for common Linux/macOS issues (e.g., file permissions, line endings, CLI installation).
- In the 'Deployment commands' section, present Azure CLI (cross-platform) examples before PowerShell (Windows-centric) examples.
Create Pull Request