Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by consistently presenting PowerShell examples alongside Azure CLI and Portal, with PowerShell (a Windows-centric tool) given equal prominence to CLI. There is no mention of Linux-specific shell usage (e.g., Bash), nor are there examples tailored for Linux environments. The prerequisites and instructions reference PowerShell modules and cmdlets without clarifying cross-platform compatibility or providing Linux/Bash alternatives. The CLI examples are generic and do not address Linux-specific nuances, such as authentication or environment setup. No Linux tools or patterns are discussed, and PowerShell is presented as a primary method for querying, which may mislead users into thinking it's required or preferred, especially for Windows users.
Recommendations
- Add explicit Bash shell examples for Azure CLI commands, showing usage in typical Linux environments (e.g., authentication, environment variables, piping output).
- Clarify that Azure CLI is cross-platform and can be used in Linux, macOS, and Windows, while PowerShell is available on all platforms but is traditionally Windows-centric.
- Include notes or sections on installing and using Azure CLI in Linux distributions, including troubleshooting common Linux-specific issues.
- Where PowerShell is referenced, add equivalent Bash or shell script snippets for Linux users.
- Avoid presenting PowerShell as a default or primary method; instead, lead with CLI or provide equal visibility to both CLI and PowerShell, with clear platform guidance.
- Mention that Cloud Shell supports both Bash and PowerShell, and show how to select the shell.
Create Pull Request