Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides deployment command examples for both Azure CLI and Azure PowerShell, but the PowerShell example is given equal prominence to the CLI example, and there is no explicit mention of Linux-specific usage or shell environments (e.g., Bash). The CLI example is cross-platform, but the PowerShell example is Windows-centric. There are no Linux shell-specific instructions, nor is there guidance for using Bicep with Bash or other Linux tools. References to Cloud Shell are present but not elaborated upon, and the documentation does not clarify that Azure CLI works natively on Linux and macOS.
Recommendations
- Add explicit Bash/Linux shell examples alongside Azure CLI commands, clarifying cross-platform compatibility.
- Note that Azure CLI is available on Windows, Linux, and macOS, and provide installation or usage links for Linux users.
- Include a section or note on using Bicep with Linux-native tools and environments.
- Clarify that PowerShell examples are primarily for Windows users, and suggest alternatives for Linux users (e.g., Azure CLI).
- Expand the Cloud Shell section to explain its cross-platform nature and how both CLI and PowerShell can be accessed from any OS.
Create Pull Request