About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
Summary:
The documentation provides both Bash and PowerShell examples for Azure CLI commands, but the PowerShell examples are labeled as 'Formatted for PowerShell' and are always presented immediately after the Bash examples. There is a slight bias toward Windows/PowerShell by explicitly formatting and labeling PowerShell commands, while not providing equivalent detail for other shells (e.g., zsh, fish) or Linux-specific environments. The documentation does not mention Linux or macOS explicitly, nor does it provide troubleshooting or environment-specific notes for non-Windows users.
Recommendations:
- Clearly label Bash examples as 'Linux/macOS (Bash)' and PowerShell examples as 'Windows (PowerShell)' to make platform targeting explicit.
- Consider providing a short note at the beginning of the CLI section explaining that Bash examples are for Linux/macOS and PowerShell for Windows, and that Azure CLI works cross-platform.
- If possible, provide parity in detail for both environments, such as mentioning common shell differences or potential issues on Linux/macOS.
- Add troubleshooting tips or links for users running Azure CLI on Linux/macOS, especially if there are known differences.
- Consider including a table or tabbed interface for 'Linux/macOS (Bash)', 'Windows (PowerShell)', and possibly 'Windows (CMD)' if relevant, to make it clear which commands apply to which environments.
Create pull request