Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation provides detailed examples for Azure PowerShell, which is primarily a Windows-centric tool, and lists PowerShell instructions before Azure CLI. The PowerShell section includes formatting and JSON conversion examples using Windows-specific cmdlets (e.g., FT, FL, ConvertTo-Json), but there are no equivalent Bash or Linux shell examples. While Azure CLI is cross-platform and examples are included, there is no explicit mention of Linux or Bash usage, nor are there examples showing how to use CLI commands in a Linux shell environment. The documentation does not mention Linux-specific tools or patterns, and the PowerShell examples are more extensive and detailed than the CLI ones.
Recommendations
- Add explicit Bash/Linux shell examples for Azure CLI commands, including output formatting and piping (e.g., using jq for JSON parsing).
- Clarify that Azure CLI is cross-platform and provide usage notes for Linux and macOS environments.
- Balance the depth of examples between PowerShell and CLI sections, ensuring CLI examples cover similar scenarios (e.g., output formatting, filtering, JSON conversion).
- Consider including a table comparing PowerShell and CLI commands for common tasks, with notes on platform compatibility.
- Where PowerShell-specific formatting is shown (e.g., FT, FL), provide equivalent CLI/Bash approaches (e.g., grep, jq, awk).