Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all critical steps, ensuring Linux and macOS users can follow along. However, Azure PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI, and in some sections, PowerShell-specific instructions are included (such as environment variable creation and AKS credential import). The tab order and structure present Windows tooling as a first-class citizen alongside the cross-platform CLI, which can subtly reinforce Windows-centric workflows.
Recommendations
- Make Azure CLI the default or primary example, as it is cross-platform and preferred for Linux/macOS users.
- Clearly indicate that Azure PowerShell is primarily for Windows users, and that Azure CLI is recommended for cross-platform scenarios.
- Consider moving PowerShell examples to a secondary position or a collapsible section to reduce perceived parity.
- Add explicit notes about platform compatibility for each tool.
- Where possible, provide bash-native examples for environment variable creation and scripting, as these are more familiar to Linux/macOS users.
Create Pull Request