Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation exclusively uses Azure PowerShell for all examples, including resource creation and plan specification. No Azure CLI, Bash, or Linux-native command examples are provided, despite the page stating applicability to Linux VMs. The referenced 'Find and use Azure Marketplace images' link also points to a Windows/PowerShell-specific page. This creates friction for Linux/macOS users who typically use Azure CLI or Bash scripts.
Recommendations
- Add equivalent Azure CLI examples for all major steps (getting VM info, creating image definitions, creating VMs, etc.).
- Include Bash script snippets for Linux users where appropriate.
- Reference both Windows/PowerShell and Linux/CLI documentation in 'Next steps' and throughout the page.
- Clearly indicate when a step is platform-agnostic or provide platform-specific instructions side-by-side.
- Ensure ARM template examples are accompanied by CLI deployment instructions (e.g., using 'az deployment').
Create Pull Request