Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deployment, resource review, and cleanup. However, PowerShell (a Windows-centric tool) is given equal prominence to CLI, and is presented in parallel tabs throughout. There is no mention of Linux-specific shell environments (e.g., Bash), nor any explicit guidance for Linux users. The use of PowerShell may implicitly favor Windows users, as PowerShell is less commonly used on Linux compared to Bash or other shells.
Recommendations
- Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and that Bash is the default shell on most Linux systems.
- Add example commands using Bash (if any differences exist) or clarify that the CLI commands are cross-platform.
- Consider listing Azure CLI (cross-platform) examples before PowerShell (Windows-centric) examples, or clarify the order is not indicative of platform preference.
- Add a note for Linux/macOS users on how to install and use Azure CLI, if not already present.
- Remove implicit parity between PowerShell and CLI unless PowerShell is equally supported and used on Linux/macOS.