Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by consistently using Windows VM templates and Windows-specific image references in all code examples. The referenced templates and examples exclusively use 'MicrosoftWindowsServer' as the image publisher and 'WindowsServer' as the offer, with parameters for 'windowsOSVersion'. There are no Linux VM template examples, nor is there any mention of Linux image references or parameters. The only mention of Linux is in the 'Next steps' section, which links to a Linux template, but no Linux-specific example is shown or discussed in the main content.
Recommendations
- Include parallel Linux VM template examples alongside Windows examples, using 'Canonical' or other Linux publishers and appropriate offers/skus.
- Show how to specify Linux OS images in the 'imageReference' section of the template.
- Add Linux-specific configuration notes where relevant (e.g., differences in OS disk settings, diagnostics, or data disk attachment).
- Ensure that both Windows and Linux examples are presented with equal prominence throughout the documentation, not just in external links.
- Clarify any differences in disk provisioning or template structure that may apply to Linux VMs.
Create Pull Request