Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all critical steps, but consistently presents Azure PowerShell (a Windows-centric tool) alongside Azure CLI. In some sections, PowerShell examples are given equal prominence to CLI, and environment variable examples for proxy configuration are shown in both Bash (Linux/macOS) and PowerShell syntax. However, there are no Linux-specific command-line examples (e.g., Bash scripts), and PowerShell is not natively available on most Linux systems. The documentation does not mention Linux tools or patterns (such as systemd, iptables, or Linux-specific networking commands), nor does it reference macOS. Azure CLI is cross-platform, but PowerShell is presented as an alternative throughout, which may create friction for Linux/macOS users unfamiliar with PowerShell.
Recommendations
- Clearly indicate that Azure CLI is the recommended and cross-platform method for Linux/macOS users, and that PowerShell is optional for Windows users.
- Present Azure CLI examples first in each section, followed by PowerShell as an alternative for Windows users.
- Add explicit notes clarifying that Azure PowerShell commands require PowerShell Core on Linux/macOS, and provide installation links if relevant.
- Include Bash script examples or references for common tasks, especially for onboarding and proxy configuration.
- Mention Linux/macOS compatibility in prerequisites and tool installation steps.