Bias Analysis
Detected Bias Types
windows_only
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation is heavily biased toward Windows environments, with all installation instructions, prerequisites, and examples assuming Windows OS. Only Windows versions are listed as supported, and all command-line and automation examples use PowerShell and Windows-specific tools (e.g., dmgcmd.exe, registry edits, .NET Framework, Windows DPAPI). There is no mention of Linux or macOS support, nor any alternative instructions or examples for non-Windows platforms. This bias makes the documentation inaccessible to users on Linux or macOS, who cannot follow the steps or complete the setup.
Recommendations
- Explicitly state OS support: If only Windows is supported, clarify this at the top of the documentation. If Linux/macOS support is planned or available, provide equivalent instructions.
- Add Linux/macOS parity: If the self-hosted integration runtime can run on Linux/macOS, include installation steps, prerequisites, and command-line examples for those platforms.
- Provide cross-platform automation: Offer examples using Bash, Azure CLI, or other cross-platform tools, not just PowerShell.
- Document limitations: If Linux/macOS are not supported, explain why and suggest alternatives for those users.
- Avoid Windows-first language: Structure sections so that platform support is clear, and avoid implying Windows is the default or only option unless it truly is.
Create Pull Request