Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page, while claiming to support both Windows and Linux Hybrid Runbook Workers, demonstrates several Windows biases. Windows-specific tools (PowerShell 5.1, .NET Framework) are emphasized, with PowerShell-based examples and cmdlets shown first and in greater detail. ARM/Bicep/CLI/REST examples focus almost exclusively on Windows VM creation and extension installation, with Linux equivalents either missing or only referenced generically. Folder permissions and troubleshooting notes are Windows-centric, and the Bicep/ARM templates only provision Windows VMs. Linux-specific requirements and patterns are less detailed, and Linux extension installation is not covered in the infrastructure-as-code sections.
Recommendations
- Provide equivalent Linux VM creation and extension installation examples in Bicep, ARM templates, CLI, and REST API sections.
- Include Linux-specific troubleshooting steps and folder permission guidance, similar to the Windows coverage.
- Add Linux-first or side-by-side examples for PowerShell, CLI, and REST API usage, not just Windows-first.
- Expand documentation of Linux prerequisites, supported tools, and hardening/permissions requirements.
- Ensure infrastructure-as-code samples (Bicep/ARM) include Linux VM images and extension installation.
- Clarify when PowerShell Core is required or supported for Linux, and provide Bash/SSH alternatives where applicable.
Create Pull Request