Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
windows_tools
Summary
The documentation page exhibits a Windows bias in several ways. Code examples for deploying and running application packages on compute nodes use Windows-specific constructs (e.g., 'cmd /c', Windows environment variable syntax, and Windows image references), with no equivalent Linux shell or environment variable usage shown. The documentation references Windows VM images first and exclusively in code, and the command-line examples are tailored to Windows (e.g., launching .exe files with Windows paths). Linux-specific instructions are limited to brief notes about environment variable formatting, without concrete Linux shell or application invocation examples. There is no demonstration of how to use Bash, Linux VM images, or Linux application binaries in the context of Azure Batch application packages.
Recommendations
- Provide parallel Linux examples for all code snippets, including pool creation (using a Linux VM image), task command lines (using Bash syntax), and application execution (e.g., running a .sh or Linux binary).
- Show how to reference environment variables in Bash (e.g., $AZ_BATCH_APP_PACKAGE_applicationid_version) and how to launch applications on Linux nodes.
- When discussing application ID requirements, present Linux and Windows constraints side by side, and clarify differences.
- Avoid presenting Windows examples first or exclusively; alternate or combine Windows and Linux instructions to ensure parity.
- Include notes about differences in file paths, permissions, and application packaging for Linux nodes.
Create Pull Request