Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. While Azure CLI is inherently cross-platform, the page repeatedly references Windows-specific shells (CMD, PowerShell) and provides explicit instructions for Windows users before or instead of Linux equivalents. Examples for Bash are present, but guidance for Windows users is often more detailed, and Linux-specific nuances are not equally addressed. There is little mention of Linux tools or shell environments outside Bash, and no explicit parity for Linux/Unix command-line patterns beyond basic Bash usage.
Recommendations
- Ensure all command-line examples are provided for both Bash (Linux/macOS) and PowerShell/CMD (Windows), with equal detail and clarity.
- When referencing shell-specific syntax (e.g., arrays, variables), provide side-by-side examples for Bash, PowerShell, and CMD.
- Explicitly mention Linux/macOS environments in prerequisites and instructions, not just Windows.
- Include troubleshooting tips or notes for common Linux/macOS issues (e.g., file permissions, path formats).
- Reference Linux tools (e.g., curl, jq) where appropriate, and avoid assuming Windows as the default environment.
- Add a section or table summarizing differences in Azure CLI usage between Windows and Linux/macOS.
Create Pull Request