Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a Windows bias by exclusively providing examples for Windows OS images and configurations, such as using 'MicrosoftWindowsServer' and 'batch.node.windows amd64' in both REST API and C# SDK examples. There are no equivalent examples or guidance for Linux OS images, agent SKUs, or Linux-specific configuration properties. Windows-specific properties (e.g., 'enableAutomaticUpdates') and tools (Windows Update) are discussed without mentioning Linux alternatives. The documentation does not show how to provision a pool with Auto OS Upgrade for Linux nodes, nor does it mention Linux agent SKUs or image references.
Recommendations
- Add parallel examples for Linux pools, including REST API and SDK code snippets using Linux image references (e.g., Ubuntu, CentOS) and the appropriate nodeAgentSKUId (e.g., 'batch.node.ubuntu 20.04').
- Include Linux-specific configuration properties and explain how automatic OS upgrades work for Linux nodes, including any differences in upgrade mechanisms compared to Windows.
- Mention Linux equivalents to Windows-specific tools and properties, such as how patching and upgrades are handled for Linux VMs.
- Ensure that all sections referencing Windows images, agent SKUs, or configuration properties also provide Linux alternatives or explicitly state their applicability.
- Review the FAQ and requirements sections to include Linux-specific considerations and guidance.
Create Pull Request