Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias. PowerShell and Windows-centric tools (Az PowerShell cmdlets, internal cmdlets) are emphasized throughout, with examples and instructions almost exclusively for Windows PowerShell. There are no Bash, CLI, or Linux-native scripting examples. The only alternatives shown are Python runbooks, but these are not positioned as Linux-specific solutions. The documentation does not mention Linux or macOS environments, nor does it provide parity for users who may want to manage Azure Automation variables using Bash, Azure CLI, or other cross-platform tools.
Recommendations
- Add examples for managing variables using Azure CLI (az automation variable ...), which is cross-platform.
- Include Bash or shell script examples for Linux/macOS users, especially for common tasks like creating, retrieving, and updating variables.
- Explicitly mention Linux/macOS compatibility in relevant sections, clarifying which tools and approaches work across platforms.
- Reorder sections so that cross-platform or platform-neutral approaches (e.g., Azure portal, Azure CLI, Python) are presented before or alongside Windows PowerShell examples.
- Provide guidance for users running runbooks or scripts on Linux Hybrid Runbook Workers, including any limitations or differences.
Create Pull Request