Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page exhibits a Windows bias in several ways: PowerShell commands are used exclusively for Azure Batch and Data Factory management, with no equivalent CLI or Bash examples for Linux users. Command examples for custom activities use Windows-specific tools (e.g., 'cmd /c', '.exe' files) and mention Windows-native commands before any cross-platform alternatives. There is no guidance or sample for running Linux shell scripts or using Linux-based tools in custom activities, nor is there mention of Linux VM pool configuration or parity in workflow. References to Windows tools and patterns are prevalent, while Linux equivalents are absent.
Recommendations
- Provide Azure CLI and Bash examples alongside PowerShell commands for managing Azure Batch and Data Factory resources.
- Include sample custom activity definitions that execute Linux shell scripts (e.g., 'bash script.sh') or Linux-native binaries, and clarify how to target Linux pool nodes.
- Explicitly document how to configure Azure Batch pools with Linux VM images and how custom activities differ on Linux vs. Windows nodes.
- Mention cross-platform considerations for custom applications (e.g., .NET Core, Python) and provide code samples for both Windows and Linux environments.
- Ensure references to Windows tools (e.g., 'cmd /c', '.exe') are balanced with Linux equivalents (e.g., '/bin/bash', '.sh'), and clarify OS-specific behaviors.
Create Pull Request