Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Azure CLI and PowerShell examples for cluster creation and encryption management, but PowerShell is featured prominently, especially for ARM template deployment and enabling encryption at host. The ARM template deployment example is shown only with PowerShell, and PowerShell is mentioned in the FAQ for key recovery before the CLI equivalent. There are no Linux shell (bash) or macOS-specific examples, and PowerShell is a Windows-centric tool. The ordering of examples sometimes places PowerShell before CLI, and the use of PowerShell for ARM template deployment may create friction for Linux/macOS users.
Recommendations
- Add bash (Linux/macOS) examples for ARM template deployment using Azure CLI (e.g., az deployment group create).
- Where PowerShell is used, provide equivalent bash/CLI commands and mention cross-platform alternatives.
- In the FAQ, list CLI and PowerShell recovery options together or put CLI first to avoid Windows-first ordering.
- Clarify that Azure CLI is cross-platform and recommend it for Linux/macOS users.
- Review and balance the ordering of examples so that CLI or bash examples are not always after PowerShell.
Create Pull Request