About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
powershell_heavy
Summary:
The documentation provides both Azure CLI and PowerShell examples for deploying Bicep files at the subscription scope. However, the PowerShell example is given equal prominence as the Azure CLI example, and there is no explicit mention of Linux or Bash scripting. The CLI example is cross-platform, but the PowerShell example (and references to Azure PowerShell) may be perceived as Windows-centric, especially since PowerShell is traditionally associated with Windows environments. There are no Linux-specific examples or explicit notes about using Bash or other shells.
Recommendations:
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and that the CLI example is cross-platform.
- Consider providing a Bash shell example or clarifying that the Azure CLI example is intended for Bash (Linux/macOS) and CMD/PowerShell (Windows) environments.
- Add a note that Azure PowerShell is available cross-platform, but is most commonly used in Windows environments, and provide guidance for Linux users if needed.
- Ensure that references to deployment commands and further reading include links to Linux/Bash-specific guidance where available.
- If possible, include a table or section summarizing command usage across different operating systems to reinforce parity.
Create pull request