Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell and Windows-centric tools are mentioned as onboarding and management channels before Linux equivalents, and there is a lack of explicit Linux-specific examples or instructions. The documentation refers to the 'System' account for Windows and only briefly mentions the 'nxautomation' account for Linux, without further Linux-specific operational details. The onboarding and management channels (Azure portal, PowerShell cmdlets, Bicep, ARM templates, REST API, Azure CLI) are listed with PowerShell first, reinforcing a Windows-first perspective. There are no Linux shell (bash) or Linux-native tool examples, and troubleshooting or operational guidance is not balanced between Windows and Linux.
Recommendations
- Provide explicit Linux shell (bash) examples alongside PowerShell for installation, management, and troubleshooting.
- Ensure Linux-specific operational details (such as permissions, service accounts, log locations, and troubleshooting steps) are documented at parity with Windows.
- List onboarding and management channels in a neutral order or alternate between Windows and Linux tools (e.g., Azure CLI before PowerShell in some sections).
- Include screenshots or walkthroughs for Linux environments, not just Windows.
- Clarify any differences in behavior, limitations, or requirements between Windows and Linux Hybrid Runbook Workers.
- Add troubleshooting guidance and common scenarios specifically for Linux hosts.
Create Pull Request