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 and deleting resources, but PowerShell instructions are presented as a primary alternative to Azure CLI, with no mention of Linux/macOS-specific shell environments or tools. The SSH key creation section does mention both 'az sshkey create' and 'ssh-keygen', but overall, Windows-centric tools (PowerShell) are given parity with CLI, and there is no explicit guidance for Linux/macOS users regarding their native environments. The documentation does not reference Windows-only tools, but the structure and example ordering may create friction for Linux/macOS users.
Recommendations
- Explicitly mention Linux/macOS environments and provide guidance for using Bash or Zsh shells, including any OS-specific considerations for Azure CLI.
- Clarify that Azure CLI commands work on Linux/macOS and Windows, and provide troubleshooting tips for common issues on non-Windows platforms.
- Reorder examples to present Azure CLI (cross-platform) instructions first, and clearly label PowerShell as a Windows-specific alternative.
- Add notes or sections for Linux/macOS users, such as how to install Azure CLI and kubectl on those platforms.
- Avoid implying parity between PowerShell and Bash unless both are equally supported and documented.
Create Pull Request