Document Details
Automation Runbook Graphical Error Handling
❌
This page contains Windows bias
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:
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
⚠️
windows_first
Summary:
The documentation page demonstrates a strong bias toward Windows and PowerShell environments. All examples, terminology, and cmdlets are PowerShell-centric, with no mention of Linux, Bash, or cross-platform scripting. Windows tools and patterns (e.g., PowerShell cmdlets like Start-AzVM, Write-Warning, Get-AutomationVariable) are used exclusively, and there are no Linux or Bash equivalents provided. The error handling concepts are described solely in the context of PowerShell, and the documentation implicitly assumes the reader is operating in a Windows/PowerShell environment.
Recommendations:
- Include examples using Bash or Python runbooks, which are supported in Azure Automation, to illustrate error handling in non-Windows environments.
- Mention and demonstrate how error handling works in Linux-based runbooks, including differences in error types and handling patterns.
- Provide parallel examples for common tasks (e.g., starting a VM, sending notifications) using both PowerShell and Bash/Python.
- Clarify in the introduction that the guidance is PowerShell-specific, or restructure the documentation to address both Windows and Linux automation scenarios equally.
- Reference relevant Linux tools or scripting patterns (e.g., try/catch in Bash, error codes, set -e) where appropriate.
Create pull request