Bias Analysis
Detected Bias Types
windows_tools
powershell_heavy
windows_first
missing_linux_example
Summary
Although the documentation is focused on Linux VMs, there is notable Windows bias in several areas. PowerShell examples and tools (e.g., Set-AzVMRunCommand, Get-AzVMRunCommand) are heavily featured alongside Azure CLI, and in some cases, Windows-specific instructions or terminology (such as PowerShell script references, Windows VM notes, and SAS token generation with PowerShell) are presented without equivalent Linux-native alternatives. REST and ARM template examples also use Windows-centric script samples (e.g., Write-Host, .ps1 files) instead of Linux shell scripts. The PowerShell section is much more extensive than the Azure CLI section, with more advanced scenarios only covered in PowerShell. Some notes and explanations reference Windows behaviors before Linux, and there are missing Linux-native examples for tasks like SAS token generation and blob management.
Recommendations
- Expand Azure CLI examples to cover all advanced scenarios currently only shown in PowerShell (e.g., streaming output to blob, running as a different user, passing parameters).
- Replace or supplement REST and ARM template script samples with Linux shell script examples (e.g., use 'echo Hello World!' or bash scripts instead of 'Write-Host' and .ps1 files).
- Provide Linux-native instructions for generating SAS tokens and managing blobs (e.g., using Azure CLI or azcopy), not just PowerShell.
- Ensure notes and explanations reference Linux behaviors first or equally, especially when describing parameter passing or script execution.
- Clarify when PowerShell commands are cross-platform (e.g., PowerShell Core on Linux) or provide explicit bash/CLI alternatives.
Create Pull Request