Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides examples for Azure CLI and Azure PowerShell, but does not offer any Linux/macOS-specific shell commands or workflows. While Azure CLI is cross-platform, the PowerShell examples are Windows-centric and are presented alongside CLI examples in every section. There are no bash-specific instructions, nor are Linux-native tools or patterns (e.g., bash scripting, environment variables, package managers) mentioned. The documentation also references PowerShell installation and usage before mentioning Linux or macOS alternatives, and does not clarify that Azure CLI commands are equally applicable on Linux/macOS.
Recommendations
- Clarify that Azure CLI commands work identically on Linux, macOS, and Windows.
- Add bash/zsh shell examples for common operations, especially for scripting or automation tasks.
- Include installation instructions for Azure CLI and kubectl on Linux/macOS, not just Windows/PowerShell.
- Reduce the prominence of PowerShell by moving CLI examples first, and making PowerShell examples optional or secondary.
- Explicitly mention Linux/macOS compatibility in prerequisites and command sections.
- Where PowerShell is used for object manipulation, provide equivalent bash/jq or Python examples for Linux users.
Create Pull Request