Detected Bias Types
Powershell Heavy
🔧
Windows Tools
Windows First
Missing Linux Example
Summary
While the documentation is focused on Linux VMs and provides Azure CLI examples for Linux shell scripts, there is a notable bias toward PowerShell and Windows-centric tooling. Many advanced examples and features (such as output streaming, SAS token generation, and parameter passing) are only demonstrated using PowerShell cmdlets, with little or no equivalent Azure CLI or Linux-native command coverage. REST and ARM template examples often use PowerShell script syntax (Write-Host, .ps1), and instructions for generating SAS tokens reference PowerShell tools first. Some sections (e.g., parameter passing, output blob streaming) lack Linux CLI parity, and Windows terminology (e.g., 'myscript.ps1', 'ipconfig') appears before or instead of Linux equivalents.
Recommendations
- Provide Azure CLI examples for all advanced scenarios currently covered only by PowerShell (e.g., output/error blob streaming, parameter passing, long-running scripts).
- Use Linux shell script syntax (e.g., .sh, echo) in REST and ARM template examples, or show both Windows and Linux script examples side by side.
- Reference Linux-native tools for SAS token generation and blob management (e.g., az storage blob generate-sas) before or alongside PowerShell equivalents.
- Ensure command IDs and examples use Linux-relevant commands (e.g., ifconfig, bash scripts) and avoid Windows-first terminology (e.g., ipconfig, .ps1) unless explicitly targeting Windows.
- Clarify differences in parameter passing and script invocation between Linux and Windows, with explicit Linux examples.