Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias by providing PowerShell-based examples for cluster management tasks (e.g., using Select-AzSubscription and Invoke-AzResourceAction), referencing PowerShell commands for node management, and omitting equivalent CLI or Bash examples for Linux/macOS users. The use of 'Az Module' and explicit PowerShell command links further reinforces this bias. No Linux/macOS-specific instructions or parity examples are given for critical operations.
Recommendations
- Provide Azure CLI (az) command examples alongside or instead of PowerShell for all management tasks, as Azure CLI is cross-platform.
- Explicitly mention that all API calls and ARM template operations can be performed from any OS, and provide Bash/cURL examples for REST API calls.
- Where PowerShell commands are referenced (e.g., az sf cluster node add/remove), clarify that these are available via Azure CLI and show usage in Bash.
- Add a section or callouts for Linux/macOS users, ensuring parity in instructions and tooling.
- Avoid referencing 'Az Module' or PowerShell-specific tooling as the primary or only method for resource management.
Create Pull Request