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 exhibits a strong Windows and PowerShell bias. PowerShell (including Windows PowerShell and PowerShell Workflow) is presented first and in greatest detail, with numerous examples and troubleshooting steps focused on Windows-specific paths, tools, and cmdlets. Many examples reference Windows file paths (e.g., C:\modules), environment variables, and PowerShell-specific modules. Linux is only mentioned in passing, often as a limitation (e.g., certain runbooks can't run on Linux Hybrid Runbook Workers), and there are no Linux-specific examples or guidance. Python runbooks receive less detailed coverage, and Linux-specific considerations are minimal or absent.
Recommendations:
- Provide Linux-specific examples for PowerShell and Python runbooks, including file paths, environment variables, and troubleshooting steps relevant to Linux Hybrid Runbook Workers.
- Balance the order of presentation by not always listing Windows/PowerShell options first; consider grouping by cross-platform compatibility or providing parallel sections for Windows and Linux.
- Include explicit notes and examples for running runbooks on Linux Hybrid Runbook Workers, including any differences in behavior, limitations, or best practices.
- Where Windows tools, paths, or patterns are mentioned (e.g., C:\modules, .ps1 scripts), provide Linux equivalents (e.g., /opt/automation/modules, ./child-runbook.ps1) where applicable.
- Expand the Python runbook section to include more parity with PowerShell, such as troubleshooting, best practices, and Linux-specific guidance.
- Add a summary table or matrix indicating which runbook types and features are supported on Windows vs. Linux Hybrid Runbook Workers.
Create pull request