Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation provides examples for Azure CLI, Azure PowerShell, and Azure Portal. While Azure CLI is cross-platform, Azure PowerShell is primarily used on Windows and is presented equally alongside CLI, with no mention of Linux-specific shell patterns (e.g., Bash, scripting, environment variables). There are no Linux-specific examples, nor are Linux shell idioms (such as piping, jq, or bash scripting) demonstrated. The ordering of examples does not always prioritize CLI (which is more universal) over PowerShell (which is Windows-centric), and PowerShell is given parity in all sections.
Recommendations
- Add explicit Linux/Bash shell examples, including usage with environment variables, piping, and tools like jq for output parsing.
- Clarify that Azure CLI commands work on Linux, macOS, and Windows, and provide sample shell scripts for Linux users.
- Consider reordering examples to present Azure CLI first, emphasizing its cross-platform nature.
- If PowerShell is included, note that it is available on Linux but less commonly used, and provide guidance for Linux users who may prefer Bash.
- Include troubleshooting notes for common Linux issues (e.g., quoting, path formats) when using Azure CLI.