Bias Analysis
Detected Bias Types
windows_first
windows_tools
powershell_heavy
missing_linux_example
Summary
The documentation demonstrates a moderate Windows bias. Windows-based examples (e.g., 'windows-latest' agent pools) are shown first for C# and PowerShell, and PowerShell is included as a first-class language. The default appType for deployment is Windows, with Linux requiring explicit configuration. While Linux examples are present for JavaScript, Python, and Java, the C# and PowerShell build examples only use Windows agents, and PowerShell is inherently Windows-centric. Some deployment features (slots, Flex Consumption) are not available or are limited for Linux, but these limitations are called out. The overall structure and ordering favor Windows users, with Linux options often presented as alternatives or requiring additional steps.
Recommendations
- Present Linux and Windows examples side-by-side or alternate which is shown first, especially for C#.
- Include C# build examples using 'ubuntu-latest' agent pools to demonstrate cross-platform compatibility.
- Clarify PowerShell's Windows-only nature and suggest Bash or Python for Linux automation.
- Explicitly state platform limitations (e.g., slot support, Flex Consumption) at the top of relevant sections.
- Where features are Windows-only, provide Linux workarounds or alternatives if possible.
- Ensure all language tabs (especially C#) show both Windows and Linux agent pool options.
- Add notes or links to Linux/macOS-specific troubleshooting and best practices.
Create Pull Request