Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents both Azure CLI (cross-platform) and PowerShell examples for deploying Bicep files in Cloud Shell. However, PowerShell is highlighted alongside Bash as a shell choice, and PowerShell examples are given equal prominence to CLI. The 'Next steps' section lists PowerShell resources before CLI resources, indicating a subtle Windows-first ordering. There are no Linux-specific tools or examples, but the use of Azure CLI ensures Linux/macOS users are not blocked.
Recommendations
- List Azure CLI resources before PowerShell in 'Next steps', as CLI is more universally available.
- Explicitly mention that Azure CLI works seamlessly on Linux/macOS and is recommended for cross-platform use.
- Add a note clarifying that PowerShell is available in Cloud Shell for all platforms, but CLI may be more familiar to Linux/macOS users.
- Consider adding a brief section on using Bicep with native Linux tools or editors, if relevant.
Create Pull Request