About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
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 elaborate and appears after the Bash example. Throughout the rest of the documentation, all instructions are oriented around the Azure Portal GUI, which is platform-agnostic, but there are no CLI examples (such as Azure CLI or Azure Cloud Shell) that would be more familiar to Linux users. The only command-line examples are Bash and PowerShell for token generation, with no mention of Linux-specific tools or workflows elsewhere. There is a slight Windows bias in the inclusion of a detailed PowerShell example and the lack of parity in CLI-based resource creation or management steps.
Recommendations:
- Provide Azure CLI examples for all resource creation and management steps, not just portal-based instructions.
- Ensure that Bash and PowerShell examples are equally detailed and placed in parallel, not with one being more elaborate.
- Explicitly mention that Bash examples are suitable for Linux/macOS users and PowerShell for Windows users.
- Include references to Azure Cloud Shell, which is cross-platform and accessible from any OS.
- Where possible, avoid Windows-first ordering (e.g., always listing PowerShell before Bash) and instead present both options side-by-side.
Create pull request