Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides parallel instructions for Azure CLI, Azure PowerShell, and Azure Developer CLI, but PowerShell is featured as a primary option alongside CLI, and no explicit Linux/macOS shell examples (e.g., bash, zsh) are given. The PowerShell instructions and references may create friction for Linux/macOS users, as PowerShell is not the default shell on those platforms. The document does not mention or show Linux-specific patterns or tools, nor does it clarify that Azure CLI commands work natively on Linux/macOS. The order of examples sometimes puts PowerShell before CLI, and there is no explicit guidance for Linux users.
Recommendations
- Add explicit bash/zsh examples for Linux/macOS users, especially for steps involving file editing and environment variables.
- Clarify that Azure CLI commands work natively on Linux/macOS and provide installation links for those platforms.
- Reorder example tabs to put Azure CLI (cross-platform) first, followed by PowerShell (Windows-centric), and then Azure Developer CLI.
- Mention that PowerShell is optional and not required for Linux/macOS users.
- Include notes or callouts for Linux/macOS users where file paths, editors, or shell commands may differ.
Create Pull Request