Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and PowerShell examples for all operations, with REST API calls as a third option. PowerShell is a Windows-centric tool, and its examples are given equal prominence to Azure CLI, which is cross-platform. In each section, Azure CLI examples are shown before PowerShell, which slightly favors Linux/macOS users. However, there are no Linux-specific shell examples (e.g., Bash scripts), nor is there mention of Linux/macOS authentication nuances. The documentation does not reference any Windows-only tools or patterns, but the inclusion of PowerShell throughout may be unnecessary for Linux/macOS users.
Recommendations
- Add explicit notes confirming Azure CLI works on Linux/macOS and provide links to installation guides for those platforms.
- Consider including Bash script examples for common tasks, especially for automation scenarios.
- Clarify that PowerShell Core is available cross-platform, or note that PowerShell examples are primarily for Windows users.
- Add troubleshooting notes for authentication on Linux/macOS if relevant (e.g., az login differences).