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:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation provides both Azure CLI and PowerShell examples, but the CLI example is written in a way that uses Windows/PowerShell variable syntax (e.g., $variable), and the PowerShell example is given in full. There are no explicit Linux/bash-native examples, and the CLI example is not shown in a cross-platform shell style (e.g., bash arrays or environment variables). This may confuse or disadvantage Linux users, as the CLI example is not directly copy-pastable into a bash shell.
Recommendations:
- Provide a true bash/Linux example for the Azure CLI commands, using bash variable syntax (e.g., export SUBSCRIPTION_ID=..., arrays with parentheses, etc.).
- Clarify which code blocks are for PowerShell and which are for bash, and ensure both are present where relevant.
- Avoid using PowerShell array syntax (e.g., [String[]]$resources = @(...)) in CLI examples; instead, show how to pass multiple --service-resources arguments in bash.
- Add a section or note specifically for Linux/macOS users, demonstrating the same workflow in a bash shell.
- Ensure the order of examples does not always present Windows/PowerShell first; consider alternating or presenting both in parallel.
Create pull request