Sad Tux - Windows bias detected
This page contains Windows bias

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

Bias Analysis

Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deploying and deleting AKS clusters, but PowerShell examples are given equal prominence and detail as CLI, which is more Windows-centric. There is no explicit mention of Linux/macOS terminal usage, nor are there examples for Bash scripting or native Linux tools beyond Azure CLI. The instructions for using Visual Studio Code and Cloud Shell are cross-platform, but the documentation does not clarify Linux/macOS-specific steps or highlight their parity. Azure PowerShell is presented as a primary option alongside CLI, which may create friction for Linux users unfamiliar with PowerShell.
Recommendations
  • Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and recommend CLI as the default cross-platform approach.
  • Move Azure CLI examples before PowerShell examples to emphasize cross-platform compatibility.
  • Add notes or sections clarifying that all steps (including Visual Studio Code usage and Cloud Shell) are supported on Linux/macOS.
  • Remove or de-emphasize PowerShell as a primary option, or clarify its Windows-centric nature.
  • Provide Bash script examples for common tasks (e.g., file creation, SSH key management) to help Linux users.
  • Add troubleshooting notes for Linux/macOS users where differences may arise (e.g., file paths, permissions).
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-13 23:55 #119 completed Biased Biased
2026-01-13 06:17 #110 completed Biased Biased
2026-01-12 00:00 #102 completed Biased Biased

Flagged Code Snippets