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:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation presents both Azure CLI and Azure PowerShell examples for all queries, but there is a notable bias toward Windows/PowerShell patterns. PowerShell examples are always present and sometimes explained in more detail (e.g., use of ConvertTo-Json and depth), and Windows-centric tools and patterns (PowerShell variables, cmdlets) are used throughout. In the multi-step public IP address example, the Azure CLI workflow uses Unix tools (awk, sed, tail), but there is no explicit mention of Linux shell environments or guidance for Linux users. The JSON output examples use Windows-centric values (e.g., WindowsServer images, osType: Windows), and there is no mention of Linux VMs or their properties.
Recommendations:
- Add explicit Linux/Unix shell examples (e.g., bash, zsh) for workflows involving Azure CLI, especially for variable handling and file manipulation.
- Include examples or notes for querying Linux virtual machines (e.g., using 'osType: Linux', 'publisher: Canonical', etc.) in JSON and queries.
- Balance explanations between PowerShell and CLI, ensuring that CLI examples are as detailed and accessible as PowerShell ones.
- When discussing output formatting (e.g., ConvertTo-Json in PowerShell), provide equivalent CLI/jq or other Linux-friendly alternatives.
- Avoid Windows-centric sample data where possible, or provide parallel Linux examples (e.g., show both Windows and Linux VM JSON).
- Clarify in notes or callouts when CLI examples assume a Unix-like shell, and provide Windows CMD or PowerShell equivalents if needed.
Create pull request