Document Details
Use System Pools
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides examples for Azure CLI and Azure PowerShell, but does not offer any Linux-specific shell examples (e.g., Bash) or macOS-specific guidance. The introductory 'Before you begin' section lists Azure CLI first, but then gives equal coverage to Azure PowerShell, which is primarily a Windows-centric tool. Throughout the page, every operation is shown with both Azure CLI and Azure PowerShell, but there are no examples using Bash scripts, Linux-native tools, or macOS-specific instructions. There is also no mention of Linux package managers for installing the CLI, nor any troubleshooting tips for non-Windows environments. The documentation assumes parity between CLI and PowerShell, but PowerShell is not the default shell for most Linux/macOS users.
Recommendations
- Add explicit Bash shell examples for all CLI commands, showing usage in a Linux/macOS terminal.
- Include installation instructions for Azure CLI using Linux package managers (apt, yum, etc.) and macOS (Homebrew).
- Clarify that Azure CLI commands work natively in Bash/zsh/fish and are cross-platform, while PowerShell is optional for Linux/macOS.
- Add troubleshooting notes for common Linux/macOS issues (e.g., permissions, path, SSH key generation differences).
- Consider reordering examples to show Azure CLI (Bash) first, then PowerShell, to reflect the cross-platform nature of AKS.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-14 00:00 | #253 | completed |
Biased
|
| 2026-01-13 00:00 | #249 | completed |
Biased
|