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. While Azure CLI is cross-platform, Azure PowerShell is primarily associated with Windows environments, and its inclusion as a primary example can signal Windows bias. There are no explicit Linux shell (bash/zsh) or scripting examples, nor is there mention of Linux-specific patterns or tools. The ordering of examples consistently places Azure PowerShell before the Portal, and there is no discussion of Linux-specific considerations (such as shell escaping or scripting integration).
Recommendations
- Add explicit bash/zsh shell examples for running az graph queries, including guidance on escaping quotes and handling output in Linux environments.
- Clarify that Azure CLI is cross-platform and provide Linux-specific usage notes where relevant.
- Consider reordering examples so that cross-platform tools (Azure CLI) are presented before Windows-centric ones (Azure PowerShell), or provide parity in scripting examples for both platforms.
- Include troubleshooting notes or tips for common Linux shell issues (e.g., quoting, piping output to jq for JSON parsing).
- If PowerShell is shown, mention that PowerShell Core is available on Linux, and provide Linux installation/usage links.
Create Pull Request