Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides three options for enabling the service principal: Microsoft Entra ID portal, Azure PowerShell, and Azure CLI. The PowerShell method is described in detail and presented before the Azure CLI method. PowerShell is primarily a Windows tool, and its prominence may create friction for Linux/macOS users. The Azure CLI example is present, which improves parity, but PowerShell is still given more emphasis and appears first.
Recommendations
- Present Azure CLI examples before PowerShell examples, as CLI is cross-platform.
- Expand Azure CLI instructions to match the detail given for PowerShell (e.g., explain how to retrieve the service principal ID if needed).
- Explicitly state that Azure CLI works on Windows, Linux, and macOS.
- Consider adding bash or shell script examples if relevant.
- Clarify that PowerShell Core is available cross-platform, but most users on Linux/macOS will prefer Azure CLI.
Create Pull Request