Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page exhibits a strong Windows bias. Most command-line examples use PowerShell, and Windows tools (e.g., cmd, .exe files) are referenced exclusively or before any Linux equivalents. There are no Linux shell (bash/sh) examples, nor are Linux-native tools or patterns (such as .sh scripts or bash commands) mentioned. The documentation implies Windows as the default environment for custom activities, with commands like 'cmd /c dir' and references to .exe applications, and does not provide parity for Linux users or guidance for running custom activities on Linux Batch pool nodes.
Recommendations
- Provide equivalent examples for Linux environments, such as bash/sh commands (e.g., 'bash -c "echo hello world"') and .sh scripts.
- Mention and demonstrate how to use Linux-based Batch pool nodes, including specifying OS type in pool configuration.
- Include sample custom applications as .sh or Python scripts, not just .exe files.
- Show how to execute and monitor pipelines using Azure CLI or REST API, not only PowerShell.
- Clarify that both Windows and Linux are supported as Batch pool node operating systems, and highlight any differences in command syntax or file handling.
- Add notes or tables comparing Windows and Linux usage patterns for custom activities, including environment setup, file paths, and command execution.
Create Pull Request