Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation provides examples for Azure CLI and Azure PowerShell, but PowerShell examples are given equal prominence to CLI, and are included throughout. There is no mention of Linux/macOS-specific shell environments (e.g., Bash), nor are there any examples using native Linux tools or scripting patterns. The documentation refers to 'Azure PowerShell' and 'Azure CLI' as cross-platform, but does not clarify that PowerShell is available on Linux/macOS, nor does it provide any Linux/macOS-specific guidance or troubleshooting. The ordering of examples sometimes places PowerShell after CLI, but both are presented as primary options, with no explicit Linux-first or parity focus. No Windows-only tools (e.g., cmd.exe, Windows-only GUIs) are referenced, but the lack of Linux/macOS-specific context or examples may create friction for non-Windows users.
Recommendations
- Explicitly state that both Azure CLI and Azure PowerShell are cross-platform and available on Linux/macOS.
- Add Bash shell examples for template deployment and resource management, especially for Linux/macOS users.
- Include troubleshooting steps or notes relevant to Linux/macOS environments (e.g., file paths, permissions, shell differences).
- Clarify that Azure PowerShell can be used on Linux/macOS, and link to installation guides for those platforms.
- Consider ordering CLI/Bash examples before PowerShell to better reflect typical Linux/macOS user workflows.
- Add a section or callout for Linux/macOS users, highlighting any differences or considerations.