Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Bash and PowerShell examples for all command-line operations, but PowerShell examples are consistently presented immediately after Bash, and often include more detailed scripting (such as use of ConvertFrom-JSON, Select-Object, and Set-Content). There is a slight 'Windows-first' bias in the sense that PowerShell is given equal or greater prominence, and some advanced scripting steps are only shown in PowerShell. There are no Linux-specific tools or patterns (such as jq, sed, or awk) used in the Bash examples, and no mention of Linux-specific troubleshooting or environment setup. All examples use Azure CLI, which is cross-platform, but PowerShell scripting is more advanced and assumes Windows familiarity.
Recommendations
- Add Linux-specific scripting examples where advanced manipulation is required (e.g., use jq in Bash for JSON processing, instead of only showing ConvertFrom-JSON in PowerShell).
- Ensure that Bash examples are as detailed and complete as PowerShell ones, especially for steps involving file manipulation or JSON editing.
- Explicitly mention cross-platform compatibility of Azure CLI and clarify any OS-specific caveats (e.g., file path syntax, environment variable usage).
- Include troubleshooting notes for common Linux shell issues (e.g., quoting, environment variables, file permissions).
- Consider listing Bash examples before PowerShell, or alternating the order, to avoid implicit prioritization of Windows/PowerShell.