Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for most steps, but PowerShell is presented as a first-class option throughout, and in some sections (especially resource group deletion), PowerShell is shown alongside CLI without explicit Linux/macOS alternatives. There is no explicit mention of Linux/macOS-specific considerations, and Windows/PowerShell patterns are given equal prominence to CLI, which is more cross-platform. Some PowerShell commands (e.g., Set-AzAksCluster) are Windows-centric and may not be directly usable on Linux/macOS. No Linux-specific troubleshooting or parity notes are provided.
Recommendations
- Clearly indicate that Azure CLI is the recommended cross-platform tool and present CLI examples first in all sections.
- Add explicit notes clarifying that Azure PowerShell is primarily for Windows users, and that Linux/macOS users should use Azure CLI.
- Remove or de-emphasize PowerShell examples in sections where CLI is sufficient and more portable.
- Add troubleshooting or parity notes for Linux/macOS users, especially where PowerShell commands may not work or require additional setup.
- Ensure all code blocks and instructions are tested and validated on Linux/macOS shells (bash/zsh) and clarify any differences.
Create Pull Request