Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Bash and PowerShell examples for all Azure CLI commands, ensuring coverage for both Linux/macOS and Windows users. However, PowerShell examples are given equal prominence to Bash, which may be unnecessary given that Azure CLI is cross-platform and Bash is the default shell for most Linux/macOS environments. The use of PowerShell examples throughout the page, rather than focusing primarily on Bash (with a note for Windows users), reflects a mild Windows bias. Additionally, instructions for stopping the log stream mention both Ctrl-C and Cmd-C, but do not reference Linux-specific shortcuts or considerations.
Recommendations
- Make Bash the default or primary example, with PowerShell examples available via tabs or expandable sections for Windows users.
- Clarify that Bash commands work on Linux/macOS and Windows (with WSL or Git Bash), and that PowerShell is primarily for native Windows environments.
- Add notes or guidance for Linux users regarding shell compatibility, especially if any command syntax differs.
- Ensure that instructions for stopping log streams mention Linux-specific shortcuts (e.g., Ctrl-C) and clarify any differences for macOS/Windows.
- Consider reducing the prominence of PowerShell examples unless there are Windows-specific behaviors or requirements.
Create Pull Request