Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell instructions for signing in to the registry, but PowerShell is given equal prominence to CLI, which is a Windows-centric tool. There are no Linux/macOS-specific shell examples (e.g., Bash), and PowerShell is presented as a primary option alongside CLI, potentially creating friction for Linux/macOS users who are less likely to use PowerShell. However, Docker installation links are provided for all platforms, and the main workflow is portal- and Docker-based, which is cross-platform.
Recommendations
- Clearly indicate that Azure CLI is cross-platform and preferred for Linux/macOS users, while PowerShell is primarily for Windows.
- Present Azure CLI instructions before PowerShell, or mark CLI as the default/recommended path for non-Windows users.
- Add explicit Bash shell examples for Linux/macOS users where relevant.
- Add a note clarifying platform suitability for each tool (e.g., 'Azure PowerShell is recommended for Windows users; Azure CLI is recommended for Linux/macOS').