About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation page demonstrates a strong Windows and PowerShell bias. PowerShell (including Windows PowerShell and PowerShell Workflow) is presented first and in the most detail, with extensive examples and troubleshooting focused on Windows paths, tools, and cmdlets. Many examples and limitations reference Windows-specific file paths (e.g., C:\modules), environment variables, and behaviors. There is little to no Linux-specific guidance, examples, or troubleshooting, and Linux is only mentioned in passing (e.g., 'can run on Linux Hybrid Worker'), without concrete examples or parity in troubleshooting. Python runbooks receive less coverage, and Linux-specific details are minimal.
Recommendations:
- Provide Linux-specific examples for PowerShell runbooks, especially for Hybrid Runbook Workers running on Linux (e.g., file paths, environment variables, module locations).
- Include troubleshooting steps and known issues relevant to Linux environments, not just Windows (e.g., what to do if a module path is /usr/local/share/powershell/Modules).
- Balance the order and prominence of runbook types: consider presenting Python and PowerShell equally, or at least avoid always listing Windows/PowerShell first.
- Where Windows-specific tools or patterns are mentioned (e.g., C:\modules, .ps1 script execution), provide Linux equivalents (e.g., /opt/automation/modules, ./child-runbook.ps1 with Linux path syntax).
- Expand the Python runbook section to include more parity with PowerShell, such as common troubleshooting, best practices, and examples for both Windows and Linux Hybrid Workers.
- Explicitly call out any differences or additional steps required for Linux Hybrid Runbook Workers throughout the documentation, not just in limitations.
Create pull request