Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell instructions for stopping and starting AKS clusters. However, Azure PowerShell examples are given equal prominence to Azure CLI, and PowerShell is a Windows-centric tool. In the 'Before you begin' section, Azure PowerShell is mentioned before the Azure portal, and is listed alongside Azure CLI as a way to create clusters, which may suggest Windows-first thinking. There are no Linux-specific examples or notes, and no mention of Bash, shell scripting, or Linux/macOS nuances. The CLI instructions are cross-platform, but the inclusion and equal emphasis on PowerShell may create friction for Linux/macOS users.
Recommendations
- Clearly state that Azure CLI works on Windows, Linux, and macOS, and is the recommended cross-platform tool.
- Move Azure CLI instructions before PowerShell in all sections to reinforce cross-platform parity.
- Add a note clarifying that Azure PowerShell is primarily for Windows users, and that Linux/macOS users should use Azure CLI.
- Consider removing PowerShell examples from the main flow, or placing them in a separate tab or appendix for Windows users.
- Add explicit Bash/shell examples where relevant, or clarify that the CLI commands work in Bash, zsh, etc.
Create Pull Request