Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page exhibits a notable Windows bias. Code examples for deploying and executing application packages on compute nodes are exclusively in C# using the Batch .NET library, with all sample VM configurations and command lines referencing Windows (e.g., WindowsServer images, 'cmd /c', Windows-style environment variables, and .exe files). Linux equivalents (such as using a Linux VM image, bash command lines, or Linux application binaries) are not provided, and Windows-specific patterns and tools are mentioned first or exclusively. While the documentation does mention Linux nodes in passing (e.g., environment variable formatting), it does not provide concrete Linux-focused examples or guidance.
Recommendations
- Add parallel Linux examples for all code snippets, including pool creation with a Linux VM image and task command lines using bash (e.g., '/bin/bash -c ...') and Linux application binaries.
- Show how environment variables and application package paths should be used on Linux nodes, with sample command lines.
- Include guidance on differences in application ID restrictions and environment variable formatting for Linux, with practical examples.
- Reference and provide examples using cross-platform SDKs (e.g., Python, REST API) where possible, not just .NET.
- Explicitly mention Linux/macOS support and any caveats or best practices for those platforms.
Create Pull Request