Bias Analysis
Detected Bias Types
windows_tools
powershell_heavy
windows_first
missing_linux_example
Summary
While the page is intended for Linux VMs, there is notable Windows bias in the documentation. PowerShell (Set-AzVMRunCommand, etc.) is heavily featured alongside Azure CLI, and many examples and notes reference Windows-specific tools, parameters, and patterns. Some examples use Windows-centric terminology (e.g., 'ipconfig' as a commandId, PowerShell script references in REST/ARM templates), and PowerShell is presented as a primary management method, even though Linux users are more likely to use Azure CLI or native Linux tools. There are also sections where Windows behaviors are described before Linux equivalents, and some REST/ARM examples use PowerShell scripts instead of shell scripts.
Recommendations
- Prioritize Azure CLI and Bash examples for Linux-focused documentation, and move PowerShell examples to a secondary position or a dedicated section.
- Ensure all REST/ARM template examples use shell scripts (e.g., 'echo Hello World!' or bash scripts) rather than PowerShell scripts.
- When referencing commandIds, use Linux-relevant commands (e.g., 'ifconfig') rather than Windows ones like 'ipconfig'.
- Clarify in notes and parameter explanations when a behavior is Windows-only, and provide Linux-specific guidance first.
- Where PowerShell is shown, explicitly note that it is cross-platform (if so), or provide Bash/CLI equivalents.
- Review all examples and ensure that Linux users can follow them without needing to interpret or translate Windows/PowerShell-specific instructions.
Create Pull Request