Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for connecting to the AKS cluster, but lists PowerShell as a primary tab alongside CLI, and specifically calls out PowerShell usage for local environments before mentioning Azure CLI. There are no explicit Linux-only examples, and the workflow assumes users are either using the Azure Cloud Shell (which is cross-platform) or Windows tools (PowerShell). There are no references to Linux-specific shell environments (e.g., bash) or macOS, and no troubleshooting or alternative instructions for Linux/macOS users. The resource deletion steps are portal-only and do not mention CLI commands, which are often preferred by Linux users.
Recommendations
- Add explicit bash/Linux/macOS instructions and examples for all steps, especially for connecting to the cluster and managing resources.
- List Azure CLI (bash) instructions before PowerShell, as CLI is cross-platform and more commonly used on Linux/macOS.
- Include a section on deleting resources using Azure CLI commands (e.g., az group delete) for parity with portal instructions.
- Clarify that Cloud Shell is available on all platforms and provide guidance for local Linux/macOS environments.
- Avoid assuming PowerShell is the default for local environments; mention bash/zsh as alternatives.
Create Pull Request