Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. Azure PowerShell examples are provided alongside Azure CLI for every query, and PowerShell-specific notes and output handling (e.g., ConvertTo-Json, variable usage) are included. Windows-centric resource properties (e.g., osType: Windows, windowsConfiguration) are shown in JSON samples. When scripting with Azure CLI, Linux tools (awk, sed, tail) are used, but there is no explicit mention of Linux shell environments or alternatives for Windows users. The PowerShell examples and notes are more detailed than the CLI equivalents, and Windows terminology appears first in several places.
Recommendations
- Add explicit notes about running Azure CLI commands in Bash (Linux/macOS) and PowerShell (Windows), clarifying environment differences.
- Provide equivalent examples for Linux and macOS users, including shell scripting alternatives for PowerShell variable handling.
- Balance PowerShell-specific notes with Bash/Linux shell scripting notes, especially regarding output formatting and file handling.
- Include sample JSON outputs for Linux-based VMs and resources, not just Windows-centric properties.
- Where possible, alternate the order of CLI and PowerShell examples, or group them together without preference.
- Add links or references to cross-platform scripting guides for Azure CLI and PowerShell.
Create Pull Request