Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation page demonstrates a notable bias toward Windows/PowerShell environments. Most examples, code snippets, and workflows are centered around PowerShell and PowerShell Workflow runbooks, with detailed explanations and screenshots. The process for passing parameters, especially from local machines, is exclusively described using PowerShell commands, with no equivalent CLI or Linux/macOS shell examples. SDK and REST API sections are platform-neutral, but the practical, step-by-step guidance for local execution is Windows/PowerShell-centric. Python runbooks are mentioned, but only briefly and without concrete parameter-passing examples from Linux/macOS environments.
Recommendations
- Add equivalent examples for starting runbooks and passing parameters using Azure CLI (az automation runbook start) and Bash scripts, suitable for Linux/macOS users.
- Include instructions for preparing and passing JSON objects to runbooks using Azure CLI or REST API from non-Windows platforms.
- Provide sample workflows for Python runbooks, including parameter passing from Linux/macOS terminals.
- Clarify that PowerShell examples are cross-platform where applicable (e.g., PowerShell Core/7+), or explicitly note Windows-only limitations.
- Reorder or balance examples so that PowerShell and non-PowerShell approaches are presented with equal prominence.