Document Details
Concepts Identity
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
missing_linux_example
Summary
The documentation page consistently presents authentication and access workflows using Azure CLI commands (e.g., 'az login', 'az aks get-credentials') and browser-based authentication, which are cross-platform but are most commonly associated with Windows environments. There is no mention of Linux/macOS-specific nuances, nor are there examples or notes about differences in experience for non-Windows users. The documentation does not reference PowerShell or Windows-only tools, but it does not provide parity examples or troubleshooting notes for Linux/macOS users, such as handling browser authentication, CLI installation, or file path differences.
Recommendations
- Explicitly state that Azure CLI and kubectl are cross-platform, and provide installation links for Linux/macOS.
- Include notes or troubleshooting tips for browser-based authentication on Linux/macOS (e.g., handling 'az login' when no browser is available).
- Add example commands showing Linux/macOS file paths (e.g., ~/.kube/config) and shell usage.
- Mention any platform-specific caveats, such as differences in credential storage or environment variables.
- If relevant, provide alternative authentication flows for headless Linux environments (e.g., device code authentication).
Create Pull Request