Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page provides a Linux-focused migration guide, but the step-by-step instructions and code samples are heavily reliant on Az PowerShell cmdlets and Windows-centric tooling. PowerShell examples are given for nearly every major operation, with only one section (disabling nodes) using Linux-native tools (ssh, bash, jq, sfctl). There is no parity for Linux CLI (Azure CLI) or bash scripting for the majority of steps, and PowerShell is presented as the default method for both production and non-production clusters.
Recommendations
- Provide equivalent Azure CLI (az) commands for all PowerShell cmdlets, especially for updating vmImage, adding/removing node types, and querying cluster state.
- Include bash script examples for common operations, such as node type management and cluster upgrades.
- Clearly indicate which steps can be performed from Linux/macOS environments and provide guidance for cross-platform users.
- Reorder examples so that Linux-native tools (Azure CLI, bash, sfctl) are shown before or alongside PowerShell examples.
- Mention installation and usage of Azure CLI for Linux users, and link to relevant documentation.
Create Pull Request