Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
minor_shell_inconsistency
Summary
The documentation provides both Azure CLI (Bash/sh) and Azure PowerShell examples in parallel, but PowerShell examples are shown in full detail, including variable assignment and token extraction, which may be more familiar to Windows users. In some places, PowerShell syntax is used for kubectl commands (e.g., variable assignment and token extraction), and the final kubectl example is shown as a PowerShell command, even though kubectl is cross-platform. There is a slight tendency to show PowerShell examples and syntax, which may create minor friction for Linux/macOS users unfamiliar with PowerShell.
Recommendations
- Ensure all kubectl examples use standard shell syntax (Bash/sh) in CLI sections and PowerShell syntax only in PowerShell sections.
- In the 'Access your cluster from a client device' section, provide both Bash and PowerShell examples for kubectl commands, or default to Bash syntax since kubectl is cross-platform.
- Clarify that Azure CLI and kubectl commands work on Linux/macOS and Windows equally, and provide explicit instructions for Linux/macOS users where variable assignment or token extraction differs.
- Consider listing CLI (Bash/sh) examples before PowerShell examples, or side-by-side, to avoid implicit Windows-first ordering.
Create Pull Request