Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides examples for Azure CLI, PowerShell, and REST API. PowerShell is given a dedicated example tab, and is listed before REST API. While Azure CLI is cross-platform, PowerShell is primarily associated with Windows, and no Linux/macOS-specific shell examples (such as Bash/cURL for REST) are provided. The ordering of examples (CLI, then PowerShell, then REST) may subtly prioritize Windows users, and the lack of explicit Linux/macOS shell examples creates minor friction for non-Windows users.
Recommendations
- Add a Bash/cURL example for querying the REST API, demonstrating how Linux/macOS users can retrieve the health state.
- Clarify that Azure CLI is cross-platform and works on Linux/macOS as well as Windows.
- Consider listing REST API and CLI examples before PowerShell, or grouping all examples equally to avoid implicit prioritization.
- Explicitly mention that PowerShell Core is available on Linux/macOS if relevant.