Bias Analysis
Detected Bias Types
windows_first
windows_tools
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates several types of Windows bias. Windows-specific tools and APIs (such as Windows Data Protection API and RDP) are mentioned before or instead of Linux equivalents. Example code and scenarios often use Windows-centric command lines (e.g., 'cmd /c echo') and VM images (WindowsServer) before Linux examples. There is a lack of parity in showing Linux-specific commands or tools, and the documentation does not provide Linux shell command examples for tasks, nor does it mention Linux alternatives to Windows-specific APIs. The initial connection instructions also prioritize RDP for Windows before SSH for Linux.
Recommendations
- Provide Linux shell command examples (e.g., 'bash -c "echo hello"') alongside Windows 'cmd /c' examples in all code snippets.
- Mention Linux tools and APIs (such as GnuPG, OpenSSL, or Linux file permissions) when discussing scenarios like secret sharing, in addition to Windows DPAPI.
- Ensure Linux connection instructions (SSH) are presented before or alongside Windows (RDP) instructions.
- Include Linux-specific code snippets and configuration details for all supported languages, not just for pool creation but also for task execution.
- Balance the order of presentation so that Linux and Windows scenarios/examples are given equal prominence.
- Add references to Linux security practices and isolation mechanisms where Windows-specific security notes are present.
Create Pull Request