Bias Analysis
Detected Bias Types
windows_first
windows_tools
powershell_heavy
missing_linux_example
Summary
The documentation generally maintains parity between Windows and Linux, but several sections show a Windows-first bias. Windows examples and instructions are presented before Linux equivalents, and Windows-specific tools and patterns (such as PowerShell and .NET in-process/isolated worker details) are more prominently featured. Some instructions, especially for Python, explicitly state lack of Windows support but do not provide alternative Linux guidance in the same section. The troubleshooting and verification steps reference Windows-centric tools and settings before Linux ones.
Recommendations
- Present Windows and Linux instructions side-by-side or in parallel tabs, rather than Windows first.
- Ensure all examples (especially CLI commands and portal steps) are provided for both Windows and Linux, even if the steps are similar.
- Where Windows-only features or limitations exist (e.g., Python not supported on Windows), provide clear Linux alternatives and cross-reference them directly.
- Reduce the prominence of Windows-specific tools (such as PowerShell) unless necessary, and highlight cross-platform tools (like Azure CLI) equally.
- Add explicit troubleshooting steps for Linux environments, including log access and dependency management.
- Review and balance language in notes and tips to avoid assuming Windows as the default platform.
Create Pull Request