Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation consistently provides Azure PowerShell examples alongside Azure CLI and classic CLI, but does not offer any Linux/macOS-specific shell examples (e.g., bash, zsh). PowerShell is a Windows-centric tool, and its inclusion as a primary example may create friction for Linux/macOS users. Additionally, PowerShell examples are always listed first, reinforcing a Windows-first approach. No explicit Linux tools or shell commands are mentioned, and there is no guidance for Linux users who may not have PowerShell installed.
Recommendations
- Add bash/zsh shell examples for Azure CLI commands, demonstrating usage in a typical Linux/macOS environment.
- Explicitly note that Azure CLI is cross-platform and provide installation or usage tips for Linux/macOS users.
- Reorder examples so that Azure CLI (cross-platform) is listed before PowerShell, or group examples by platform.
- Clarify that PowerShell is optional and primarily relevant for Windows users.
- Consider removing or de-emphasizing Azure classic CLI if it is deprecated, and focus on modern, cross-platform tools.
Create Pull Request