Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides examples for Azure CLI, Azure PowerShell, and the Azure Portal, but does not include explicit Linux shell (bash/zsh) or scripting examples. While Azure CLI is cross-platform, the presence of Azure PowerShell examples (which are more commonly used on Windows) and the lack of Linux-specific shell usage or notes may indicate a subtle Windows bias. Additionally, PowerShell examples are always presented alongside CLI, and there is no mention of Linux-specific considerations (such as escaping quotes in bash, or using jq for output parsing).
Recommendations
- Add explicit bash/zsh examples for each query, showing how to run az graph query in a Linux shell, including any necessary escaping or output parsing.
- Include notes about differences in shell quoting and escaping between Windows (PowerShell) and Linux (bash/zsh).
- If output parsing or further scripting is common, provide examples using Linux tools (e.g., jq, grep, awk) to process results.
- Clarify that Azure CLI is cross-platform and highlight any platform-specific caveats.
- Consider reordering examples so that cross-platform tools (Azure CLI) are presented before platform-specific ones (PowerShell), or group them together under a 'Scripting' heading.
Create Pull Request