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 demonstrates a mild Windows bias by consistently presenting PowerShell examples before Azure CLI examples in all code sections. The PowerShell sections are more detailed, with richer example scripts and explanations, while Azure CLI sections are more succinct and sometimes refer to external documentation for examples. There is no mention of Linux-specific tools, shells, or workflows, and the documentation implicitly assumes familiarity with PowerShell, which is more common on Windows.
Recommendations:
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI examples first in some sections to avoid reinforcing a Windows-first perspective.
- Ensure that Azure CLI examples are as detailed and comprehensive as the PowerShell examples, including full command sequences and explanations.
- Explicitly mention that Azure CLI commands are cross-platform and can be run on Linux, macOS, and Windows, to encourage non-Windows users.
- Where appropriate, add Bash shell examples or notes for Linux/macOS users (e.g., variable syntax differences, login methods).
- Avoid assuming PowerShell as the default scripting environment; clarify that both PowerShell and CLI are supported equally.
Create pull request