Bias Analysis
Detected Bias Types
windows_tools
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. Azure PowerShell (a Windows-centric tool) is featured alongside Azure CLI in every example, with detailed PowerShell usage notes (e.g., ConvertTo-Json, variable handling) that are specific to Windows environments. Shell scripting examples for Azure CLI use Unix tools (awk, sed, tail), but there is no mention of Windows equivalents (e.g., PowerShell cmdlets or batch scripting), nor is there guidance for running CLI commands on Windows. The JSON output examples and resource properties are heavily focused on Windows VMs (e.g., WindowsServer image, osType: Windows, windowsConfiguration), with no Linux VM examples or properties shown.
Recommendations
- Add Linux VM examples and properties (e.g., osType: Linux, imageReference for Ubuntu or CentOS) in JSON output and queries.
- Include Azure CLI command usage on Windows (e.g., using PowerShell or cmd.exe), or provide equivalent PowerShell scripting for CLI examples.
- Balance PowerShell-specific notes with Bash/Linux shell notes, such as handling JSON output or variables in Bash.
- Explicitly mention cross-platform support for Azure CLI and PowerShell, and provide guidance for users on both Windows and Linux.
- Where scripting is shown (e.g., file handling, text processing), provide both Bash (Linux/macOS) and PowerShell (Windows) approaches.
Create Pull Request