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 all operations, but consistently presents PowerShell examples alongside CLI, and sometimes before or with equal prominence. PowerShell is a Windows-centric tool, and the CLI examples use syntax that is compatible with both Windows and Linux, but there is no explicit mention of Linux or Bash-specific usage. There are no Linux-only examples, nor is there guidance for Linux users regarding shell differences (e.g., variable assignment differences between Bash and PowerShell).
Recommendations:
- Explicitly mention that Azure CLI commands are cross-platform and provide Bash-specific syntax for variable assignment (e.g., myActions='["..."]' vs. myActions=(...)).
- Add a 'Bash' tab or section for variable assignment and command usage, clarifying differences from PowerShell.
- If PowerShell is included, clarify that it is primarily for Windows users, and recommend Azure CLI for Linux/macOS users.
- Consider providing a short note or table at the start of the 'Deploy the Bicep file' section indicating which tools are available on which platforms.
- Ensure that all examples are tested and shown to work on Linux shells (Bash, zsh) and not just Windows/PowerShell.
Create pull request
Flagged Code Snippets
# [PowerShell](#tab/PowerShell)
# [PowerShell](#tab/PowerShell)
# [PowerShell](#tab/PowerShell)
# [PowerShell](#tab/PowerShell)
# [PowerShell](#tab/PowerShell)
# [PowerShell](#tab/PowerShell)