Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for obtaining access tokens and making REST calls. However, PowerShell examples are given equal prominence and detail as CLI, despite PowerShell being primarily a Windows tool. There is no explicit mention of Linux/macOS alternatives for PowerShell commands, nor is there any guidance for Bash scripting or other Linux-native tools beyond cURL and Azure CLI. Some links and references (such as deploying with PowerShell) are Windows-centric, and PowerShell is presented as a first-class option alongside CLI, which may create friction for Linux/macOS users.
Recommendations
- Clearly indicate that Azure PowerShell commands are primarily for Windows users, and recommend Azure CLI or Bash for Linux/macOS.
- Provide Bash script examples for multi-step operations (e.g., using cURL with jq for parsing responses).
- Ensure that CLI examples are shown before PowerShell, or default to CLI/Bash in cross-platform documentation.
- Add explicit notes or sections for Linux/macOS users, highlighting any differences or limitations.
- Where PowerShell is referenced for deployment, provide equivalent CLI or Bash instructions and links.
Create Pull Request