Bias Analysis
Detected Bias Types
windows_tools
windows_examples
windows_linux_equivalence
windows_first
Summary
The documentation provides both Windows and Linux information for AKS, but there is a notable bias toward Windows in several areas. Examples for installing and using kubectl are given for both Azure CLI and Azure PowerShell, but PowerShell (Windows-centric) is presented as an equal alternative to CLI, which is cross-platform. OS component tables consistently list Windows alongside Linux distributions, sometimes with Windows-specific tools and add-ons. In command examples, Windows tools (PowerShell cmdlets) are given equal prominence to CLI commands, and sometimes appear before Linux equivalents. However, Linux is well-represented in component lists and technical details.
Recommendations
- Present Azure CLI (cross-platform) examples before PowerShell examples, and clarify that PowerShell is Windows-specific.
- Explicitly state which commands/tools are cross-platform and which are Windows-only.
- Where possible, provide bash/Linux shell equivalents for any PowerShell-specific instructions.
- In tables and lists, group Linux and Windows components separately to avoid implying parity where it may not exist.
- Add notes or links for Linux/macOS users on how to install or use tools if only Windows instructions are given.
Create Pull Request