Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and PowerShell examples for all major operations, but PowerShell (a Windows-centric tool) is consistently presented alongside or immediately after CLI. There are no explicit Linux/macOS shell examples (e.g., Bash, zsh), nor any mention of platform-specific considerations for non-Windows users. The CLI examples are generic and would work cross-platform, but the documentation does not clarify this, nor does it offer parity for Linux/macOS users in terms of troubleshooting, environment setup, or alternative tools. PowerShell is given equal or greater prominence, and some output examples are shown only in PowerShell syntax.
Recommendations
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and clarify any platform-specific differences if present.
- Add Bash/zsh shell examples for Linux/macOS users, especially for scripting and output parsing.
- When showing output or scripting examples, alternate between PowerShell and Bash to demonstrate parity.
- Include troubleshooting or installation notes for Azure CLI and PowerShell on Linux/macOS.
- Avoid presenting PowerShell examples first or exclusively; lead with CLI or provide both side-by-side.
- Mention that Visual Studio Code is cross-platform and highlight any Linux/macOS-specific setup steps if relevant.
Create Pull Request