Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page exhibits moderate Windows bias. Azure PowerShell is featured as a primary tool alongside Azure CLI, with PowerShell examples and terminology presented in detail. In some cases, PowerShell examples are provided before or alongside CLI, but there is little explicit mention of Linux/macOS environments or shell-specific differences. The CLI examples use Bash syntax, but there is no discussion of Linux-specific considerations, nor are there examples for Linux-native tools or shell environments beyond Bash. The PowerShell section is extensive, and the CLI examples sometimes use PowerShell syntax (variable assignment) without clarifying cross-platform differences. There are no explicit Linux/macOS instructions or troubleshooting notes.
Recommendations
- Clarify that Azure CLI works natively on Linux/macOS and provide explicit Bash and PowerShell syntax examples where variable assignment differs.
- Add notes or sections highlighting Linux/macOS environments, including shell differences, installation prerequisites, and troubleshooting tips.
- Ensure CLI examples use pure Bash syntax and avoid PowerShell-style variable assignment unless specifically targeting PowerShell users.
- Add explicit Linux/macOS screenshots or terminal output where relevant.
- Mention cross-platform compatibility for all tools and provide links to installation guides for Linux/macOS users.
Create Pull Request