Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all deployment and management steps. However, PowerShell is featured equally alongside CLI, and PowerShell is a Windows-centric tool. There is a slight 'windows_first' bias in the variable assignment examples, as PowerShell syntax is shown and referenced, and the documentation mentions PowerShell tools (e.g., Get-AzActionGroup) before their CLI equivalents in some places. There are no explicit Linux shell (bash) examples, nor is there guidance for Linux-specific environments or scripting patterns. The documentation assumes familiarity with PowerShell and does not provide parity for Linux users beyond the CLI commands.
Recommendations
- Add explicit bash shell examples for variable assignment and command usage, showing how to declare arrays and pass parameters in bash.
- When referencing tools for obtaining resource IDs (e.g., action groups), mention the Azure CLI command before or alongside the PowerShell command, and provide example output for both.
- Include notes or guidance for Linux/macOS users about environment differences, such as quoting and array syntax.
- Clarify that Azure CLI is cross-platform and highlight its usage for Linux/macOS users.
- Consider adding a section or tab for bash scripting, especially for multi-value parameters, to ensure Linux parity.
Create Pull Request