Bias Analysis
Detected Bias Types
windows_first
windows_tools
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates some Windows bias. Windows VM images and considerations are presented before Linux equivalents in the 'Supported VM images' section. There are several references to Windows-specific paths (e.g., C:\ProgramData\Docker, c:\app\myApp.exe) and behaviors (ephemeral disk mapping, Windows container limitations) without equivalent Linux details. Example code for container tasks includes a Windows path and command line, but does not provide a Linux shell example for the same scenario. There is also a lack of parity in troubleshooting and advanced configuration examples, which tend to reference Windows specifics more than Linux.
Recommendations
- Ensure Linux examples are presented alongside Windows examples, especially for container task command lines and working directory configuration.
- Provide equivalent Linux shell command examples where Windows paths and commands are shown (e.g., show '/app/myApp' and '/bin/bash' examples next to 'c:\app\myApp.exe').
- Balance the order of presentation so that Linux and Windows are treated equally in lists and explanations, rather than Windows-first.
- Add troubleshooting steps and advanced configuration examples for Linux containers, not just Windows.
- Where Windows-specific limitations or behaviors are described, include Linux-specific notes for parity.
- Avoid using only Windows paths in code samples; provide Linux alternatives or use platform-neutral notation.
Create Pull Request