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/cURL and PowerShell/Invoke-WebRequest examples for all major steps, but there is a subtle Windows bias: PowerShell is mentioned first in the prerequisites, and Windows/PowerShell is often referenced before Bash/Linux. The use of Windows-specific terminology (e.g., 'on Windows PowerShell') and the explicit mention of credential pop-ups (a Windows UX pattern) further reinforce this bias, even though Linux/Bash examples are present and complete.
Recommendations:
- List Bash/cURL examples before PowerShell/Windows examples to avoid the perception of Windows-first bias.
- In the prerequisites, mention Bash/cURL before PowerShell/Invoke-WebRequest, or present them in parallel.
- Use neutral language such as 'On Bash' and 'On PowerShell' instead of 'on Windows PowerShell', to avoid platform-preference signaling.
- Where possible, provide parity in explanation detail for both Bash and PowerShell examples (e.g., credential handling).
- Consider a tabbed or side-by-side layout for Bash and PowerShell examples to emphasize equal support.
Create pull request