Bias Analysis
Detected Bias Types
windows_tools
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page, while focused on Linux VMs, includes significant PowerShell usage and references to Windows-centric tools and patterns. PowerShell examples are provided extensively alongside Azure CLI, but some examples and notes reference Windows-specific behaviors or tools (e.g., 'ipconfig', 'Write-Host', SAS token generation with PowerShell). REST API and ARM template examples use Windows-style scripts (.ps1) and 'Write-Host', and PowerShell is presented with equal or greater prominence than Azure CLI. Some explanations and examples lack explicit Linux shell script equivalents, and Windows terminology is used in parameter explanations.
Recommendations
- Ensure all script examples in REST API and ARM template sections use Linux shell scripts (e.g., 'echo Hello World!', '.sh' files) when the context is Linux VMs.
- Replace or supplement PowerShell-centric instructions (e.g., SAS token generation, 'Write-Host') with Azure CLI or Linux-native alternatives.
- Clarify when a command or parameter is Windows-specific versus Linux-specific, especially in sections describing parameter passing and script execution.
- Present Azure CLI examples before PowerShell, as CLI is more native to Linux environments.
- Add explicit Linux shell script examples for all major scenarios, including REST API and ARM template deployments.
- Avoid referencing Windows tools (e.g., 'ipconfig') in Linux contexts; use Linux equivalents like 'ifconfig' or 'ip'.
Create Pull Request