Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell is used for several key examples (ARM template deployment, enabling encryption at host), and Windows-centric tools (PowerShell cmdlets) are referenced for operations like key recovery. Examples for cluster creation and key rotation are provided for Azure CLI (cross-platform), but PowerShell is given equal or greater prominence, and no Linux/macOS shell (bash) or automation examples are shown. The order of presentation often puts PowerShell or portal (Windows-centric) before CLI. There are no explicit Linux/macOS instructions for tasks like ARM template deployment or key recovery.
Recommendations
- Add bash or shell script examples for ARM template deployment and cluster creation, demonstrating parity for Linux/macOS users.
- Reference cross-platform tools (e.g., Azure CLI, REST API) before or alongside PowerShell in all sections.
- For key recovery, provide Azure CLI equivalents before PowerShell, and clarify which tools are cross-platform.
- Explicitly state that Azure CLI commands work on Linux/macOS and Windows.
- Where PowerShell is used, offer alternative commands for bash/zsh users.
Create Pull Request