Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation page references Windows-specific tools and patterns before Linux/macOS equivalents, notably in the 'Before you begin' section, where Azure PowerShell and Azure CLI are both mentioned as options for cluster creation, but PowerShell is listed before the Azure portal and after CLI. There are no explicit Linux/macOS-only examples missing, and all command-line instructions use bash and kubectl, which are cross-platform. However, the mention of PowerShell and the ordering of Windows tools before Linux alternatives may create a perception of Windows bias.
Recommendations
- List cross-platform tools (Azure CLI, kubectl) before Windows-specific tools (PowerShell) in all instructions and prerequisites.
- Explicitly state that all command-line instructions work on Linux, macOS, and Windows (with WSL or bash).
- Provide links or notes for Linux/macOS users where Azure PowerShell is mentioned, clarifying that Azure CLI is recommended for cross-platform usage.
- Consider removing or de-emphasizing PowerShell references unless a Windows-only workflow is required.
Create Pull Request