Bias Analysis
Detected Bias Types
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits a Windows bias in several ways: JSON examples for VM creation and updates consistently use Windows OS images and Windows-specific configuration fields (e.g., 'osType': 'Windows', 'windowsConfiguration', 'timeZone', 'MicrosoftWindowsServer'), with no equivalent Linux examples. Windows-centric fields are shown first and exclusively in code samples. There are no explicit Linux VM configuration examples, nor is there guidance for Linux-specific patterns or fields. While the page references a Linux IMDS sample in a link, the main content and examples are Windows-focused.
Recommendations
- Add parallel JSON examples for Linux VM creation and updates, using Linux OS images and relevant configuration fields (e.g., 'osType': 'Linux', 'linuxConfiguration').
- Include Linux-specific fields and patterns in code samples, such as SSH key configuration and Linux image references.
- Alternate the order of examples or provide both Windows and Linux examples side-by-side.
- Explicitly mention Linux support and provide guidance for Linux users in each relevant section.
- Ensure links to Linux documentation are prominent and not just in 'Next steps'.
Create Pull Request