Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page exhibits a notable Windows bias. All code examples use C#/.NET and reference Windows-specific constructs (e.g., 'cmd /c', Windows image references, Windows environment variable formats) without providing Linux or cross-platform equivalents. The documentation discusses Windows node configuration and environment variable formats first, with Linux details presented only as a secondary note. There are no Linux shell (bash) examples, nor guidance for Linux-specific deployment patterns. The use of Windows-centric tools and patterns (e.g., referencing 'cmd /c', Windows VM images) further increases friction for Linux users.
Recommendations
- Provide parallel Linux examples for all code snippets, including shell/bash command lines and Linux VM image references.
- Show how to configure application packages for Linux pools, including specifying Linux VM images in code.
- Document the differences in environment variable formatting and usage for Linux nodes with explicit examples.
- Include guidance for deploying and executing applications on Linux nodes, such as using bash scripts instead of 'cmd /c'.
- Ensure that cross-platform APIs (e.g., REST, Python, Java) are referenced and exemplified, not just .NET.
Create Pull Request