Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all major operations (attach, detach, move), as well as portal instructions. However, PowerShell examples are given equal prominence to CLI, despite PowerShell being primarily a Windows tool. In some cases, PowerShell examples are more verbose and detailed, which may subtly favor Windows users. Azure CLI is cross-platform, but there are no explicit Linux/macOS shell examples (e.g., Bash, zsh), nor any mention of Linux-specific considerations. PowerShell is presented as a first-class option, which may create friction for Linux/macOS users who do not use PowerShell.
Recommendations
- Clearly indicate that Azure CLI is cross-platform and preferred for Linux/macOS users.
- Consider providing Bash/zsh shell command examples where relevant, or clarifying that Azure CLI commands work identically on Linux/macOS.
- Add a note that PowerShell is primarily for Windows users, and recommend Azure CLI for Linux/macOS.
- If PowerShell is required for some advanced scenarios, explain how Linux/macOS users can install and use PowerShell Core.
- Review the order of examples: consider listing Azure CLI before PowerShell to reduce Windows-first bias.