Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deleting AKS node pools, but PowerShell (a Windows-centric tool) is given equal prominence to CLI, and is presented before the Azure portal instructions. There are no Linux/macOS-specific shell examples or notes, and PowerShell is not natively available on most Linux/macOS systems. The CLI examples are cross-platform, but the inclusion and prominence of PowerShell may create friction for non-Windows users.
Recommendations
- Prioritize Azure CLI examples, as they are cross-platform and work on Windows, Linux, and macOS.
- Clearly indicate that PowerShell is primarily for Windows users, and provide guidance for Linux/macOS users to use Azure CLI.
- Add notes or tabs for Bash or shell environments where relevant, especially for verification steps.
- If PowerShell is included, ensure it is presented after CLI and portal instructions, or in a separate 'Windows only' section.
- Explicitly state that Azure CLI is recommended for Linux/macOS users.
Create Pull Request