Detected Bias Types
Powershell Heavy
🔧
Windows Tools
Missing Linux Example
Windows First
Summary
The documentation is heavily focused on PowerShell and Windows-centric tools and patterns. Nearly all code examples, parameter handling, and automation scenarios are shown using PowerShell, PowerShell Workflow, or C# SDK, with only brief mention of Python runbooks. There are no examples using Bash, Azure CLI, or Linux-native tools for starting or interacting with runbooks. The only non-PowerShell runbook type discussed is Python, and even then, only minimal guidance is given. All examples for starting runbooks from the command line use PowerShell cmdlets, and there is no parity for Linux/macOS users who may prefer Bash or Azure CLI.
Recommendations
- Add examples for starting and passing parameters to runbooks using Azure CLI (az automation runbook start) with equivalent parameter handling.
- Include Bash shell examples for interacting with the REST API (using curl/jq) to start runbooks and pass parameters.
- Expand the Python runbook section with more detailed examples, including parameter handling and invocation from Linux/macOS environments.
- Clearly indicate which features or examples are Windows/PowerShell-specific, and provide Linux/macOS alternatives where possible.
- Add a table or section comparing PowerShell, Azure CLI, and REST API approaches for cross-platform automation.