Detected Bias Types
🔧
Windows Tools
Powershell Heavy
Missing Linux Example
Summary
The documentation provides both Azure CLI and PowerShell examples for all major operations, which is good for cross-platform parity. However, in the PowerShell sections, it recommends and uses ARMClient (armclient.exe), a Windows-centric tool, without mentioning Linux/macOS alternatives or clarifying ARMClient's cross-platform support. There are no examples using common Linux tools (e.g., curl, httpie) for REST operations, nor is there guidance for users who prefer Bash or native Linux/macOS shells. This creates friction for non-Windows users, especially those who do not use PowerShell.
Recommendations
- Explicitly state whether ARMClient works on Linux/macOS, or provide installation instructions for those platforms.
- Offer REST examples using curl or httpie for Linux/macOS users alongside Azure CLI and PowerShell.
- Add a Bash shell tab or section for users who prefer Bash scripting.
- Clarify that PowerShell Core (v7+) is cross-platform, but also provide non-PowerShell alternatives for REST operations.
- Mention that Azure CLI works on all platforms and is recommended for Linux/macOS users.