Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a Windows bias by providing only PowerShell-based examples for artifact creation and execution, referencing Windows-specific tools and scripts (e.g., powershell.exe, artifact.ps1, startChocolatey.ps1), and omitting equivalent Linux shell script examples. The step-by-step instructions and sample downloads are exclusively for Windows artifacts, with no guidance or samples for Linux-based artifacts. Windows terminology and tools are presented first and exclusively, leaving Linux users without clear instructions or parity.
Recommendations
- Add parallel Linux examples throughout the documentation, including sample artifact definition files and shell scripts (e.g., Bash, sh).
- Provide step-by-step instructions for creating and deploying Linux artifacts, including downloading and customizing Linux sample artifacts from the public repository.
- Show equivalent Linux commands and script references in the 'runCommand' section (e.g., bash ./artifact.sh), and clarify how to handle secure parameters in Linux scripts.
- Include screenshots or folder structure examples for Linux artifacts.
- Ensure that both Windows and Linux options are presented equally in all relevant sections, not just mentioned as possible values.
Create Pull Request