Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Bash and PowerShell examples for generating an access token, but PowerShell (a Windows-centric tool) is given equal prominence to Bash, and is presented immediately after the Bash example. Throughout the document, all instructions rely on the Azure Portal UI and do not mention command-line alternatives such as Azure CLI, which are more commonly used on Linux. There is no mention of Linux-specific tools or workflows, and no explicit guidance for Linux users in steps involving app registration, role assignment, or resource creation.
Recommendations
- Include Azure CLI examples for all steps that currently rely on the Azure Portal UI, especially for resource provider registration, resource creation, app registration, and role assignment.
- Present Bash (Linux/macOS) examples before PowerShell (Windows) examples, or clarify that both platforms are supported equally.
- Add explicit instructions or notes for Linux users, including any prerequisites or environment setup steps.
- Where screenshots are used, consider providing CLI output examples or terminal screenshots alongside portal images.
- Ensure that all automation steps (such as token generation) have parity between Bash and PowerShell, and mention cross-platform compatibility.
Create Pull Request