Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides deployment command examples for both Azure CLI and PowerShell, but the PowerShell example is given equal prominence and is listed immediately after the CLI example. There are no explicit Linux-specific instructions or examples, and the documentation does not mention Bash, shell scripting, or Linux-specific considerations. The references to Cloud Shell do not clarify that it supports Bash and PowerShell, nor do they provide Bash-specific examples. This may lead to a perception that Windows/PowerShell usage is as primary or more primary than Linux/Bash usage, especially since PowerShell is traditionally associated with Windows environments.
Recommendations
- Add explicit Bash examples alongside Azure CLI examples, especially for parameter passing and scripting.
- Clarify that Azure CLI commands work cross-platform (Windows, Linux, macOS) and highlight Bash usage for Linux users.
- In the 'Deployment commands' section, mention that PowerShell is available on Linux, but also provide Bash script equivalents for common tasks.
- In references to Cloud Shell, specify that both Bash and PowerShell are supported, and provide links or examples for Bash usage.
- Consider listing Azure CLI/Bash examples before PowerShell examples to reflect the cross-platform nature of Azure CLI.
- Add a note or section addressing Linux/macOS users, including any OS-specific considerations for Bicep deployments.
Create Pull Request