Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides examples for Azure Portal, Azure CLI, and Azure PowerShell in parallel tabbed sections. However, PowerShell is given equal prominence to CLI, despite being primarily a Windows tool. In some sections, PowerShell examples are shown immediately after CLI, and PowerShell-specific commands are referenced directly. There are no Linux-specific shell examples (e.g., Bash), and no mention of platform differences or considerations for Linux/macOS users. The CLI examples are cross-platform, but the presence and prominence of PowerShell may create a perception of Windows bias.
Recommendations
- Clarify that Azure CLI commands work on Linux, macOS, and Windows equally, and consider providing explicit Bash examples or notes for Linux/macOS users.
- Add a brief note explaining that PowerShell examples are primarily for Windows users, and that Linux/macOS users should use Azure CLI or Bash.
- Consider reordering tabs so that CLI (cross-platform) appears before PowerShell, or add a 'Bash' tab for Linux/macOS users if there are platform-specific nuances.
- Reference platform parity in introductory sections, reassuring users that all major steps can be completed on Linux/macOS using CLI.
Create Pull Request