Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation is heavily biased towards Windows and PowerShell. All code examples use Azure PowerShell, with no Azure CLI or Bash alternatives provided. Windows-specific tools and patterns (e.g., Chocolatey, sysprep, Windows image definitions) are used exclusively, and file paths are given in Windows format. There is no guidance for Linux/macOS users, nor are cross-platform instructions or examples present.
Recommendations
- Provide equivalent Azure CLI and Bash examples for all PowerShell commands.
- Include instructions for installing Azure CLI on Linux/macOS, and reference the official documentation.
- Offer Linux/macOS file path examples alongside Windows paths.
- Discuss alternatives to Chocolatey for Linux (e.g., apt, yum) and how to customize images for non-Windows OSes.
- Clearly state OS limitations (if only Windows images are supported) at the top of the article.
- If VM Image Builder supports Linux images, add a parallel Linux-focused example and template.
Create Pull Request