Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation lists both Azure CLI and PowerShell as supported CLI tools, but PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI, despite CLI being cross-platform and PowerShell being historically Windows-focused. No explicit Linux shell (bash) examples or references are provided, and no Linux-specific tools or usage patterns are mentioned. The documentation does not clarify that Azure CLI is the recommended or default tool for Linux users, nor does it provide Linux-oriented guidance or examples.
Recommendations
- Explicitly state that Azure CLI is cross-platform and the primary tool for Linux users.
- Provide example commands using bash/zsh shells to demonstrate usage on Linux.
- Clarify the platform compatibility of PowerShell and Azure CLI, noting that PowerShell Core is available on Linux but is less commonly used than CLI.
- Add a section or note for Linux users, highlighting best practices and any platform-specific considerations.
- Ensure that CLI examples precede PowerShell examples, or provide parallel examples for both environments.
Create Pull Request