Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page exhibits a strong Windows and PowerShell bias. Nearly all command-line examples use PowerShell, including REST API calls, ARM template deployments, and authentication steps. There are no CLI/bash examples for Linux/macOS users, and PowerShell is assumed as the default automation tool. Even REST API and HTTP token acquisition examples are given only in PowerShell, despite being platform-agnostic. The only non-PowerShell code sample is a brief Python example, but it does not cover the full workflow. Windows-specific paths and instructions are provided before Linux equivalents, and Windows tooling is referenced throughout.
Recommendations
- Add equivalent Azure CLI (az) examples for all PowerShell commands, especially for enabling managed identity, assigning roles, and verifying assignments.
- Provide bash/shell script examples for REST API calls and token acquisition, using curl or wget, to support Linux/macOS users.
- Include instructions for deploying ARM templates using Azure CLI (az deployment group create) and/or Bicep.
- Where file paths or agent instructions are given, present Linux and Windows steps side-by-side or in parallel, not Windows-first.
- Clarify that PowerShell commands can be run cross-platform (with PowerShell Core), or explicitly note platform requirements.
- Expand Python examples to cover more scenarios, such as role assignment and resource access, to demonstrate parity.
Create Pull Request