Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides parallel examples for Azure CLI and Azure PowerShell, but PowerShell is a Windows-centric tool and is presented as an equal alternative to the cross-platform Azure CLI. There are no explicit Linux/macOS shell examples (e.g., Bash), and PowerShell is featured in tabs throughout, which may suggest Windows as a primary platform. Additionally, environment variable usage is shown in PowerShell syntax, which differs from Bash/Linux conventions. No Linux-specific tools or patterns are mentioned, and the CLI examples do not clarify Linux/macOS usage (e.g., export vs. set for environment variables).
Recommendations
- Add explicit Bash/Linux/macOS shell examples for all CLI commands, especially for environment variable usage (e.g., 'export ACRNAME=...').
- Clarify that Azure CLI is cross-platform and provide guidance for Linux/macOS users where syntax differs.
- Reorder tabs to show Azure CLI (Bash) first, or provide a dedicated Linux/macOS section.
- Avoid presenting PowerShell as the default or primary scripting environment unless necessary.
- Include notes or callouts for platform-specific differences, especially for environment variable handling and file paths.
Create Pull Request