Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Bash and PowerShell examples for all Azure CLI commands, but PowerShell examples are always shown immediately after Bash, and in some sections (such as sending concurrent requests), the PowerShell example is more elaborate and uses advanced Windows-specific constructs (RunspacePool, etc.). There is no explicit Linux/macOS bias, but the presence and complexity of PowerShell examples may signal a slight Windows preference. However, all core tasks are fully documented for Bash, and Linux users can complete the tutorial without friction.
Recommendations
- Consider listing Bash examples first in each tabbed section to reinforce cross-platform parity.
- For sections where PowerShell uses advanced Windows-specific constructs (e.g., RunspacePool for concurrency), provide a similarly advanced Bash/Linux alternative (such as GNU Parallel or background jobs) to match capability and clarity.
- Explicitly mention that Bash examples work on Linux and macOS, and PowerShell examples are for Windows (or PowerShell Core on other platforms).
- Add a brief note at the start clarifying that all Azure CLI commands work cross-platform, and users should choose the shell that matches their OS.
Create Pull Request