Detected Bias Types
Windows First
Powershell Heavy
🔧
Windows Tools
Missing Linux Example
Summary
The documentation exhibits a notable Windows bias in several areas. Windows and PowerShell examples are frequently presented first or exclusively (e.g., .EXE, .MSI, .PS install scripts), and Windows-specific tools and patterns (msiexec, powershell.exe, .exe/.msi packaging) are emphasized. In CI/CD pipeline samples (GitHub Actions, Azure DevOps, GitLab, Jenkins), the default application and config file names are always Windows-centric (.exe, .json), and the creation of VM Application definitions defaults to Windows OS type, with no parallel Linux example. While Linux install script examples are present for .tar, .deb, .rpm, and .sh, the overall flow and automation guidance prioritize Windows scenarios, and Linux parity is not consistently maintained.
Recommendations
- Provide Linux-first or side-by-side examples for all install script types, especially for .deb, .rpm, .sh, and .tar.gz.
- In CI/CD pipeline samples, alternate or parallelize examples for Linux apps (e.g., use app.sh, app.deb, app-config.yaml) and set --os-type Linux in at least half of the samples.
- Explicitly show how to create and deploy Linux VM Applications in automation flows (GitHub Actions, DevOps, etc.), not just Windows.
- Balance the order of presentation so Linux and Windows examples are equally visible and accessible.
- Avoid defaulting to Windows file types (.exe, .msi, .json) in variable names and sample scripts; use generic or Linux-centric names where appropriate.
- Add guidance for Linux-specific packaging and deployment nuances (e.g., SELinux, systemd integration, permissions).