Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page, while focused on Linux VMs, contains several instances of Windows bias. PowerShell examples and tooling are heavily featured, with many advanced scenarios (such as output streaming, parameter passing, and SAS token generation) described only with PowerShell cmdlets and Windows-centric tools. REST and ARM template examples use PowerShell scripts as sample payloads, and some notes reference Windows-specific behaviors before Linux equivalents. There are missing Linux CLI or bash-native examples for advanced features, and PowerShell is often presented before or instead of Linux alternatives.
Recommendations
- Provide equivalent Azure CLI or bash script examples for all advanced scenarios currently shown only in PowerShell (e.g., output streaming, parameter passing, SAS token generation).
- Where REST or ARM template payloads use PowerShell scripts, also show examples with bash scripts.
- Clarify when instructions or notes are Windows-specific and provide Linux-specific guidance in parallel.
- Ensure Linux tools and patterns (e.g., az CLI, bash scripting) are presented before or alongside Windows/PowerShell examples, especially in Linux-focused documentation.
- Add instructions for generating SAS tokens using Azure CLI or portal for Linux users.
Create Pull Request