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 demonstrates a Windows and PowerShell-centric bias. PowerShell (a traditionally Windows-first technology) is presented as the primary and recommended runbook type, with extensive detail and examples focused on Windows paths, tools, and cmdlets. Many examples and known issues reference Windows-specific file paths (e.g., C:\modules), environment variables, and behaviors. Linux-specific guidance is minimal or absent, and there are no Linux shell (bash) examples. Even in sections mentioning Linux support (e.g., Hybrid Runbook Workers), practical Linux usage patterns, troubleshooting, or examples are missing.
Recommendations:
- Provide Linux-specific examples for runbook authoring and troubleshooting, such as using Linux file paths and shell commands where appropriate.
- Clarify and expand on Linux Hybrid Runbook Worker support, including any limitations, best practices, and differences from Windows workers.
- Include parity in examples: for every PowerShell/Windows example, provide an equivalent for Linux environments (e.g., bash or Python scripts interacting with Azure).
- Avoid referencing only Windows paths (like C:\modules); include Linux equivalents (e.g., /opt/automation/modules) where relevant.
- Document any Linux-specific issues, workarounds, or environment variables for Python and PowerShell runbooks on Linux Hybrid Workers.
- Reorder sections or tables to avoid always listing Windows/PowerShell first, or explicitly state that ordering does not imply preference.
- Highlight cross-platform capabilities and provide guidance for users working in non-Windows environments.
Create pull request