Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
windows_tools
Summary
The documentation provides both CLI and PowerShell examples for associating a VM to a capacity reservation group. However, there is a notable Windows bias: PowerShell (a Windows-centric tool) is always presented as a primary automation option, and ARM template and API examples use Windows Server images by default. There are no explicit Linux-specific examples in ARM templates, and PowerShell is featured equally alongside the cross-platform Azure CLI, despite CLI being more common on Linux/macOS. The ARM template only shows Windows image SKUs, and the 'OSVersion' parameter is Windows-only, with no mention of Linux images or parameters.
Recommendations
- Add Linux image options and parameters to ARM template examples (e.g., include Ubuntu or other Linux distributions in 'imageReference' and 'OSVersion').
- Provide a Linux-focused ARM template example or at least a note on how to adapt the template for Linux VMs.
- Consider presenting Azure CLI examples before PowerShell, as CLI is cross-platform and more familiar to Linux/macOS users.
- Explicitly mention that PowerShell examples are for users who have PowerShell available, and that Azure CLI is recommended for Linux/macOS.
- Where possible, clarify that the steps apply to both Windows and Linux VMs, and highlight any OS-specific differences.
Create Pull Request