Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents Azure PowerShell examples before Azure CLI examples, and provides detailed PowerShell command usage and output, including formatting and JSON conversion, which are most relevant to Windows and PowerShell users. While Azure CLI examples are present and comprehensive, there is a slight prioritization of Windows/PowerShell tooling and patterns over Linux-native equivalents. No explicit Linux shell (bash/zsh) examples or notes about cross-platform usage are provided, and PowerShell-specific formatting commands (FT, FL, ConvertTo-Json) are highlighted without Linux shell analogs.
Recommendations
- Alternate the order of PowerShell and Azure CLI sections, or present CLI examples first to avoid implicit prioritization.
- Add Linux shell (bash/zsh) examples, including usage of jq or grep for filtering and formatting JSON output from Azure CLI.
- Explicitly note that Azure CLI is cross-platform and provide guidance for both Windows and Linux users.
- Where PowerShell formatting commands are shown (e.g., FT, FL, ConvertTo-Json), provide equivalent Linux/CLI commands (e.g., jq, grep) for output manipulation.
- Include a short section or callout on platform parity, clarifying that all CLI examples work on Linux, macOS, and Windows.
Create Pull Request