Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides extensive examples for Azure CLI and Azure PowerShell, but PowerShell examples are shown alongside CLI in nearly every section and sometimes first. There are no explicit Linux/macOS shell examples (e.g., bash, zsh), and PowerShell is a Windows-centric tool (despite cross-platform support, most Linux users prefer bash). Visual Studio Code is mentioned, but not in a way that addresses OS-specific usage. The cleanup section refers to 'Azure CLI or Azure PowerShell', but the CLI tab is labeled 'CLI' rather than 'Azure CLI', which could cause confusion. No Linux-specific patterns, troubleshooting, or environment setup are discussed.
Recommendations
- Add explicit bash/zsh examples for Linux/macOS users, especially for scripting and output parsing.
- Clarify that Azure CLI commands work on Linux/macOS and provide shell-specific notes (e.g., quoting, environment variables).
- Include troubleshooting notes for common Linux/macOS issues (e.g., file permissions, path separators).
- Mention cross-platform editors (e.g., VS Code on Linux/macOS) and provide links to relevant setup guides.
- Reorder examples so Azure CLI (which is cross-platform) appears before PowerShell, or alternate the order.
- Label tabs and code blocks clearly as 'Azure CLI (Windows/macOS/Linux)' and 'PowerShell (Windows/macOS/Linux)' to reduce ambiguity.
Create Pull Request