Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation presents examples for Azure portal, PowerShell, and Azure CLI in parallel tabs, but PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI, and is described in detail. PowerShell examples are extensive and use Windows-specific patterns (e.g., Get-Date, backticks for line continuation). There are no Linux/macOS shell examples (e.g., Bash), nor is there mention of Linux-specific tools or patterns. The ordering of tabs is portal, PowerShell, then Azure CLI, subtly prioritizing Windows tools over cross-platform CLI usage.
Recommendations
- Add Bash shell examples alongside Azure CLI, showing typical usage on Linux/macOS.
- Explicitly mention that Azure CLI works cross-platform and is recommended for Linux/macOS users.
- Consider reordering tabs to show Azure CLI before PowerShell, or clarify tool parity.
- Avoid Windows-specific scripting patterns (like PowerShell's Get-Date) in generic examples; show equivalent Bash date handling.
- Add a note for Linux/macOS users about prerequisites and environment setup for CLI usage.