Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Bash and PowerShell examples for generating an access token, but the PowerShell example is more detailed and appears after the Bash example, which is a positive sign. However, throughout the document, all instructions for portal-based actions (such as app registration, role assignment, and resource creation) are described in a way that assumes use of the Azure Portal GUI, which is more familiar to Windows users. There are no CLI-based (e.g., Azure CLI) instructions for Linux users for these steps. The only command-line examples are for token generation, and while Bash is included, there is a heavier focus on PowerShell with more detailed scripting. There are no references to Linux-specific tools or patterns, and no mention of how to perform the same tasks using the Azure CLI or other cross-platform tools.
Recommendations
- Add Azure CLI examples for all steps that can be performed via CLI, such as resource provider registration, app registration, role assignment, and token generation.
- Ensure that for every PowerShell example, there is a corresponding Bash/Azure CLI example with equal detail and explanation.
- Include explicit instructions or links for Linux/macOS users, especially for steps that are currently only described using the Azure Portal GUI.
- Avoid assuming the use of the Azure Portal for all actions; provide parity for users who prefer or require command-line tools.
- Where screenshots are used, consider including CLI output examples or terminal screenshots to balance the visual focus.