Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page exhibits a notable Windows bias. PowerShell commands are used exclusively for Azure Batch account and pool creation, as well as for pipeline execution and monitoring. Windows-specific tools and patterns (e.g., .exe applications, cmd commands) are referenced throughout, with no equivalent Bash, Linux shell, or cross-platform examples. The documentation assumes the use of Windows executables and command syntax, and does not provide guidance for Linux/macOS users on running shell scripts or using non-Windows tooling.
Recommendations
- Provide equivalent Bash or Azure CLI examples for all PowerShell commands, especially for creating Batch accounts/pools and running pipelines.
- Include examples of custom activities that execute Linux shell scripts (e.g., .sh files) or commands (e.g., bash -c 'echo hello world') in addition to Windows .exe and cmd examples.
- Clarify that Azure Batch pools can use Linux VM images, and provide sample configurations and commands for Linux-based pools.
- Explicitly mention cross-platform considerations for custom applications, including how to deploy and run Python, Java, or shell scripts.
- Reorder examples to present Windows and Linux options side by side, or alternate which platform is shown first.
Create Pull Request