Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation page presents both Azure PowerShell and Azure CLI examples for all command-line steps, but consistently lists PowerShell (a Windows-centric tool) before CLI. The instructions for opening a terminal specifically mention PowerShell first and suggest using Visual Studio Code with a PowerShell terminal, which is most common on Windows. There is a slight emphasis on PowerShell-specific features (e.g., splatting) and terminology, and PowerShell examples are given before CLI in every section. However, Linux parity is generally maintained by providing CLI examples and mentioning Bash terminals.
Recommendations
- Alternate the order of PowerShell and CLI examples in sections, or present CLI first in some cases to avoid implicit prioritization of Windows tools.
- Explicitly mention that Azure CLI works on Windows, Linux, and macOS, and that Bash terminals are available on all platforms.
- Provide guidance for opening Bash terminals on Windows (e.g., via WSL or Git Bash) and on Linux/macOS, to make the instructions more inclusive.
- Avoid PowerShell-specific terminology (like 'splatting') without equivalent CLI explanations, or provide similar tips for CLI users.
- Add a brief note at the start clarifying that both PowerShell and CLI are fully supported on all major platforms, and users can choose their preferred tool.
Create Pull Request