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 tooling (e.g., Set-AzVMRunCommand, Get-AzVMRunCommand) are heavily featured, sometimes before or in greater detail than Azure CLI examples. Windows-specific tools and patterns (such as PowerShell cmdlets and SAS token generation via New-AzStorageBlobSASToken) are referenced throughout. REST API and ARM template examples use Windows-centric script examples (e.g., Write-Host, .ps1 files) instead of Linux shell scripts (.sh). Some explanations and notes reference Windows behaviors or requirements, and Linux-specific guidance is less prominent or missing in places.
Recommendations
- Ensure all examples and explanations are Linux-centric, using bash/shell scripts (.sh) instead of PowerShell (.ps1) where appropriate.
- Provide Azure CLI examples before PowerShell, as CLI is more cross-platform and native for Linux users.
- Where PowerShell cmdlets are referenced, add equivalent Azure CLI commands and highlight their use for Linux environments.
- In REST API and ARM template samples, use Linux shell script examples (e.g., 'echo Hello World!' or .sh files) rather than Windows PowerShell scripts.
- Clarify SAS token generation for Linux users, referencing Azure CLI commands instead of only PowerShell.
- Remove or minimize Windows-specific notes unless they are relevant to Linux VM scenarios.
Create Pull Request