Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides parallel examples for Azure CLI and Azure PowerShell throughout, but PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI, despite CLI being cross-platform and PowerShell being less common on Linux/macOS. In several places, instructions reference Docker for Windows and Mac, but do not mention Linux Docker installation directly. The order of presentation sometimes puts Windows/PowerShell tools on equal footing or ahead of Linux-native alternatives, and there is no explicit mention of Linux-specific package managers or shell environments.
Recommendations
- Clearly state that Azure CLI is cross-platform and recommend it as the default for Linux/macOS users.
- Add explicit instructions or links for installing Docker and Kubernetes tools on Linux (e.g., apt, yum, snap).
- Provide Linux-specific environment variable examples (e.g., bash, zsh) before or alongside PowerShell examples.
- Clarify that PowerShell is optional and primarily for Windows users; suggest Bash/CLI as the primary workflow for Linux/macOS.
- Ensure that references to Docker for Windows/Mac are accompanied by Linux installation guidance.
- Consider reordering examples to show CLI/Bash first, then PowerShell.
Create Pull Request