Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a notable Windows bias. All example configurations (REST API and C# SDK) use Windows-specific images (MicrosoftWindowsServer), Windows node agent SKUs, and Windows configuration properties. There are no Linux image examples, nor any mention of Linux-specific configuration options or node agent SKUs. The only OS-specific property discussed is 'windowsConfiguration.enableAutomaticUpdates', with no Linux equivalent or guidance. This creates friction for Linux users seeking parity or guidance.
Recommendations
- Add parallel examples using Linux images (e.g., Ubuntu, CentOS) in both REST API and SDK sections.
- Document Linux-specific configuration properties, such as 'linuxConfiguration', and node agent SKUs for Linux pools.
- Explicitly mention supported Linux OS images and provide links or lists.
- Clarify any differences in upgrade behavior or requirements for Linux pools.
- Ensure that Linux examples are presented alongside or before Windows examples to avoid implicit prioritization.
Create Pull Request