Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deploying Bicep files, but the PowerShell example is given equal prominence and detail as the CLI example. Azure PowerShell is a Windows-centric tool, and its inclusion alongside CLI (which is cross-platform) is common, but the documentation does not provide any Linux/macOS-specific guidance or mention Bash scripting, nor does it clarify that Azure CLI is the recommended cross-platform option. The order of examples (CLI first, then PowerShell) is neutral, but the presence of PowerShell examples may suggest a slight Windows bias.
Recommendations
- Explicitly state that Azure CLI is cross-platform and recommended for Linux/macOS users.
- Add a note clarifying that Azure PowerShell is primarily for Windows, and that CLI works on all platforms.
- Consider including Bash script examples for Linux users, or referencing Cloud Shell as a platform-neutral option.
- Ensure that all examples and instructions are clearly applicable to Linux/macOS environments, and avoid implying that PowerShell is required.
Create Pull Request