Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides examples and tips for Bash, PowerShell, and Windows CMD environments. However, Windows-specific environments (PowerShell and CMD) receive more detailed attention, with explicit examples and escape character guidance. PowerShell is mentioned early in the CLI requirements section, and Windows CMD is given its own section, while Linux-specific shells (e.g., Bash, Zsh) are only briefly covered. There is no mention of Linux distributions, nor examples for other popular shells used on Linux/macOS (e.g., Zsh, Fish). The documentation assumes familiarity with Windows tools and patterns, and PowerShell is referenced before Bash in some places.
Recommendations
- Add explicit examples for Linux/macOS shells beyond Bash, such as Zsh and Fish, to improve parity.
- Reorder shell-specific sections so that Bash (Linux/macOS) examples appear before PowerShell and Windows CMD, or group them together without Windows-first ordering.
- Include notes on Linux-specific considerations, such as file permissions, environment variables, and common shell patterns.
- Mention that the Azure CLI and its extensions are cross-platform and provide installation instructions for Linux/macOS alongside Windows.
- Avoid assuming PowerShell usage as the default; clarify that Bash is the default shell on most Linux/macOS systems.
- Add troubleshooting tips for common issues encountered on Linux/macOS platforms.
Create Pull Request