Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for most steps, but PowerShell examples are given equal prominence and are presented as a primary option alongside CLI. Azure PowerShell is a Windows-centric tool, and its inclusion as a first-class option (with full code blocks and tabs) may create friction for Linux/macOS users, especially since PowerShell is less commonly used on those platforms. However, all critical steps are covered with Azure CLI, which is cross-platform, and there are no Windows-only tools or commands required. The documentation does not exclusively mention Windows tools or patterns, nor does it omit Linux/macOS equivalents.
Recommendations
- Consider clarifying that Azure PowerShell is primarily for Windows users, and Azure CLI is recommended for Linux/macOS.
- Present Azure CLI examples first in all tabbed sections to reinforce cross-platform parity.
- Add a note indicating that Azure CLI is available and supported on Windows, Linux, and macOS, while PowerShell is mainly for Windows.
- If possible, reduce PowerShell prominence or move it to a secondary position in tabbed examples.
Create Pull Request