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, with Linux alternatives mentioned secondarily or only in comments. PowerShell is presented as a language option, but only with Windows-based build agents. The default deployment type is Windows, and Linux-specific instructions are often marked as exceptions or require explicit configuration. Some features (like deployment slots) are not available for Linux in certain plans, and this is noted as a limitation rather than providing alternative Linux guidance.
Recommendations
- Present Linux and Windows examples side-by-side, or alternate which is shown first to avoid implicit prioritization.
- For C# and PowerShell, provide explicit Linux build agent examples where possible (e.g., for .NET Core apps, show both 'windows-latest' and 'ubuntu-latest' pipelines).
- Clarify which features are Windows-only and offer Linux alternatives or workarounds where feasible.
- For PowerShell, mention cross-platform options (PowerShell Core on Linux) and provide Linux-compatible pipeline samples if supported.
- Avoid language in comments or notes that implies Windows is the default or preferred platform.
- Where features are unavailable for Linux, link to roadmap or alternatives for Linux users.
Create Pull Request